@mytegroupinc/myte-core 0.0.30 → 0.0.32

package/README.md

@@ -57,6 +57,9 @@ PRD document contract:
 - `myte-kanban` uploads send `{ ticket_markdown }`, where the leading JSON block contains metadata and the remaining markdown is the PRD body.
 - The backend stores the markdown as `prd_markdown`, mirrors it as PRD text for search/sync, generates a DOCX attachment from it, and marks `prd_format=markdown`.
 - The UI renders the PRD from stored PRD text/document content, not from `description`.
+- Renderer-friendly PRDs should use one `# Title`, `##` sections, concise paragraphs, bullets, GitHub tables/checklists where useful, and fenced code blocks only for real code/config.
+- Do not wrap the whole PRD in a ` ```markdown ` fence. Do not use raw HTML, inline style blocks, or decorative banners.
+- PRD identity is explicit: `myte create-prd` creates a PRD asset with PRD metadata. Generic uploaded `.md`, `.docx`, `.pdf`, and `.txt` files remain normal attachments unless explicitly created as PRDs.
 
 Feedback comment support:
 

package/cli.js

@@ -287,6 +287,8 @@ function printHelp() {
     "  - Never put the full PRD in description. The complete PRD must live in the markdown file body",
     "  - Each item carries the full PRD markdown blob as prd_markdown/ticket_markdown",
     "  - Backend stores that blob as the renderable PRD document source, mirrors it for PRD text search/sync, and generates a DOCX attachment",
+    "  - Renderer-friendly PRDs use one # title, ## sections, bullets, GitHub tables/checklists where useful, and code fences only for real code/config",
+    "  - Do not wrap the whole PRD in a ```markdown fence; generic .md/.docx/.pdf/.txt uploads are normal attachments unless created as PRDs",
     "  - PRD DOCX content: the markdown body is stored verbatim",
     "",
     "update-team contract:",
@@ -3404,6 +3406,7 @@ function writeFeedbackSnapshot({ snapshot, wrapperRoot, outputDir }) {
     const feedbackId = stableItemId(item, ["feedback_id", "id"], `F${String(index + 1).padStart(3, "0")}`);
     const conversationTurns = normalizeFeedbackConversationTurns(item.conversation_turns);
     const prdText = String(item.prd_text || "").trim();
+    const attachmentDocuments = Array.isArray(item.attachment_documents) ? item.attachment_documents : [];
 
     let contextSource = "description_only";
     let contextNote = "No separate PRD. Use feedback_text as the context for this feedback item.";
@@ -3414,8 +3417,10 @@ function writeFeedbackSnapshot({ snapshot, wrapperRoot, outputDir }) {
       const prdPath = path.join(prdSyncDir, prdFilename);
       writeTextFile(prdPath, ensureTrailingNewline(prdText));
       prdFile = toPosixRelativePath(targetRoot, prdPath);
-      contextSource = "prd_file";
-      contextNote = "Full PRD context is stored in the linked file.";
+      contextSource = attachmentDocuments.length > 0 ? "attachment_file" : "prd_file";
+      contextNote = attachmentDocuments.length > 0
+        ? "Readable feedback attachment documents are stored in the linked file."
+        : "Full PRD context is stored in the linked file.";
       prdFileCount += 1;
     } else if (item.has_prd_text) {
       contextSource = "prd_declared_but_unavailable";

package/package.json

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

package/scripts/feedback-live-full-harness.js

@@ -90,24 +90,24 @@ function writePrd(workspace, title, index) {
   return filePath;
 }
 
-function loadFeedbackManifest(workspace) {
-  const manifestPath = path.join(workspace, "MyteCommandCenter", "data", "feedback.yml");
-  if (!fs.existsSync(manifestPath)) {
-    return { items: [] };
-  }
-  const text = fs.readFileSync(manifestPath, "utf8");
-  try {
-    const parsed = JSON.parse(text);
-    const items = []
-      .concat(Array.isArray(parsed.items) ? parsed.items : [])
-      .concat(Array.isArray(parsed.queue) ? parsed.queue : []);
-    return { items };
-  } catch (_err) {
-    // Older local files may still be YAML-like. Keep a small fallback parser so
-    // the harness can validate either shape without adding runtime deps.
-  }
-  const items = [];
-  let current = null;
+function loadFeedbackManifest(workspace) {
+  const manifestPath = path.join(workspace, "MyteCommandCenter", "data", "feedback.yml");
+  if (!fs.existsSync(manifestPath)) {
+    return { items: [] };
+  }
+  const text = fs.readFileSync(manifestPath, "utf8");
+  try {
+    const parsed = JSON.parse(text);
+    const items = []
+      .concat(Array.isArray(parsed.items) ? parsed.items : [])
+      .concat(Array.isArray(parsed.queue) ? parsed.queue : []);
+    return { items };
+  } catch (_err) {
+    // Older local files may still be YAML-like. Keep a small fallback parser so
+    // the harness can validate either shape without adding runtime deps.
+  }
+  const items = [];
+  let current = null;
   for (const line of text.split(/\r?\n/)) {
     const feedbackMatch = line.match(/^\s*-\s+feedback_id:\s*["']?([^"'\s]+)["']?\s*$/) || line.match(/^\s*feedback_id:\s*["']?([^"'\s]+)["']?\s*$/);
     if (feedbackMatch) {