@mytegroupinc/myte-core 0.0.31 → 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:",
@@ -3401,25 +3403,25 @@ function writeFeedbackSnapshot({ snapshot, wrapperRoot, outputDir }) {
   let prdFileCount = 0;
   const materializedItems = items.map((rawItem, index) => {
     const item = isPlainObject(rawItem) ? { ...rawItem } : {};
-    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.";
-    let prdFile = null;
+    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.";
+    let prdFile = null;
 
     if (prdText) {
       const prdFilename = `${sanitizeFileSegment(feedbackId, `feedback-${index + 1}`)}.md`;
-      const prdPath = path.join(prdSyncDir, prdFilename);
-      writeTextFile(prdPath, ensureTrailingNewline(prdText));
-      prdFile = toPosixRelativePath(targetRoot, prdPath);
-      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;
+      const prdPath = path.join(prdSyncDir, prdFilename);
+      writeTextFile(prdPath, ensureTrailingNewline(prdText));
+      prdFile = toPosixRelativePath(targetRoot, prdPath);
+      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";
       contextNote = "A separate PRD exists for this feedback item, but readable PRD text was not included in this sync snapshot.";

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@mytegroupinc/myte-core",
-  "version": "0.0.31",
+  "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) {