Develop

data/knowledge/evidence-registry.json

@@ -0,0 +1,142 @@
+{
+  "version": "0.1.0",
+  "updatedAt": "2026-07-20",
+  "policy": {
+    "officialLevel": "A",
+    "pendingLevel": "A-PENDING",
+    "requiredFields": [
+      "id",
+      "vendor",
+      "product",
+      "documentTitle",
+      "sourceUrl",
+      "verifiedAt",
+      "appliesToVersion",
+      "status"
+    ],
+    "ruleAr": "لا تصنف أي وظيفة على أنها A قبل تسجيل رابط الوثيقة وعنوانها والإصدار وتاريخ التحقق."
+  },
+  "records": [
+    {
+      "id": "cubase-import-audio-file",
+      "vendor": "Steinberg",
+      "product": "Cubase Pro",
+      "documentTitle": "Importing Audio Files",
+      "sourceUrl": "",
+      "verifiedAt": null,
+      "appliesToVersion": "15.x",
+      "status": "pending",
+      "temporaryReliability": "A-PENDING"
+    },
+    {
+      "id": "cubase-tempo-detection",
+      "vendor": "Steinberg",
+      "product": "Cubase Pro",
+      "documentTitle": "Tempo Detection Panel",
+      "sourceUrl": "",
+      "verifiedAt": null,
+      "appliesToVersion": "15.x",
+      "status": "pending",
+      "temporaryReliability": "A-PENDING"
+    },
+    {
+      "id": "cubase-musical-mode",
+      "vendor": "Steinberg",
+      "product": "Cubase Pro",
+      "documentTitle": "Musical Mode",
+      "sourceUrl": "",
+      "verifiedAt": null,
+      "appliesToVersion": "15.x",
+      "status": "pending",
+      "temporaryReliability": "A-PENDING"
+    },
+    {
+      "id": "cubase-audio-alignment",
+      "vendor": "Steinberg",
+      "product": "Cubase Pro",
+      "documentTitle": "Audio Alignment Panel",
+      "sourceUrl": "",
+      "verifiedAt": null,
+      "appliesToVersion": "15.x",
+      "status": "pending",
+      "temporaryReliability": "A-PENDING"
+    },
+    {
+      "id": "cubase-separate-stems",
+      "vendor": "Steinberg",
+      "product": "Cubase Pro",
+      "documentTitle": "Separating Stems",
+      "sourceUrl": "",
+      "verifiedAt": null,
+      "appliesToVersion": "15.x",
+      "status": "pending",
+      "temporaryReliability": "A-PENDING"
+    },
+    {
+      "id": "suno-studio-upload-timeline",
+      "vendor": "Suno",
+      "product": "Suno Studio",
+      "documentTitle": "Upload and arrange audio in Studio",
+      "sourceUrl": "",
+      "verifiedAt": null,
+      "appliesToVersion": "1.2",
+      "status": "pending",
+      "temporaryReliability": "A-PENDING"
+    },
+    {
+      "id": "suno-studio-manual-bpm",
+      "vendor": "Suno",
+      "product": "Suno Studio",
+      "documentTitle": "Project tempo and Manual BPM",
+      "sourceUrl": "",
+      "verifiedAt": null,
+      "appliesToVersion": "1.2",
+      "status": "pending",
+      "temporaryReliability": "A-PENDING"
+    },
+    {
+      "id": "suno-studio-time-signature",
+      "vendor": "Suno",
+      "product": "Suno Studio",
+      "documentTitle": "Grid and time signature behavior",
+      "sourceUrl": "",
+      "verifiedAt": null,
+      "appliesToVersion": "1.2",
+      "status": "pending",
+      "temporaryReliability": "A-PENDING"
+    },
+    {
+      "id": "suno-studio-remove-fx",
+      "vendor": "Suno",
+      "product": "Suno Studio",
+      "documentTitle": "Remove FX",
+      "sourceUrl": "",
+      "verifiedAt": null,
+      "appliesToVersion": "1.2",
+      "status": "pending",
+      "temporaryReliability": "A-PENDING"
+    },
+    {
+      "id": "suno-studio-warp-markers",
+      "vendor": "Suno",
+      "product": "Suno Studio",
+      "documentTitle": "Warp Markers",
+      "sourceUrl": "",
+      "verifiedAt": null,
+      "appliesToVersion": "1.2",
+      "status": "pending",
+      "temporaryReliability": "A-PENDING"
+    },
+    {
+      "id": "suno-studio-export",
+      "vendor": "Suno",
+      "product": "Suno Studio",
+      "documentTitle": "Multitrack and WAV export",
+      "sourceUrl": "",
+      "verifiedAt": null,
+      "appliesToVersion": "1.2",
+      "status": "pending",
+      "temporaryReliability": "A-PENDING"
+    }
+  ]
+}

data/knowledge/manifest.json

@@ -0,0 +1,52 @@
+{
+  "version": "0.1.0",
+  "updatedAt": "2026-07-20",
+  "files": [
+    {
+      "id": "reliability",
+      "path": "data/knowledge/reliability.json",
+      "required": true,
+      "rootArray": "levels",
+      "uniqueKey": "id"
+    },
+    {
+      "id": "evidence-registry",
+      "path": "data/knowledge/evidence-registry.json",
+      "required": true,
+      "rootArray": "records",
+      "uniqueKey": "id"
+    },
+    {
+      "id": "workflow-stages",
+      "path": "data/knowledge/workflow-stages.json",
+      "required": true,
+      "rootArray": "stages",
+      "uniqueKey": "id"
+    },
+    {
+      "id": "musical-roles",
+      "path": "data/knowledge/musical-roles.json",
+      "required": true,
+      "rootArray": "roles",
+      "uniqueKey": "id"
+    }
+  ],
+  "validation": {
+    "requiredTopLevelFields": ["version", "updatedAt"],
+    "allowedReliability": ["A", "A-PENDING", "B", "C", "D"],
+    "officialEvidenceRule": {
+      "whenReliability": "A",
+      "requiredEvidenceStatus": "verified"
+    },
+    "workflowRules": {
+      "stageOrderStartsAt": 1,
+      "stageOrderMustBeContinuous": true,
+      "gateRequired": true
+    },
+    "roleRules": {
+      "purposeRequired": true,
+      "timingClassRequired": true,
+      "prohibitionsRequired": true
+    }
+  }
+}

data/knowledge/musical-roles.json

@@ -0,0 +1,116 @@
+{
+  "version": "0.1.0",
+  "updatedAt": "2026-07-20",
+  "ruleAr": "اختر الوظيفة قبل الآلة. الآلة الواحدة يمكن أن تؤدي أدوارًا مختلفة ولا تثبت فائدتها داخل التوزيع.",
+  "roles": [
+    {
+      "id": "guide",
+      "labelAr": "Guide",
+      "purposeAr": "تثبيت اللحن والبنية والوقفات مؤقتًا.",
+      "timingClass": "structural",
+      "promptGuards": ["clear complete phrases", "real section length", "clear phrase endings"],
+      "prohibitions": ["long reverb", "delay", "dense harmony", "fills inside vocal gaps"],
+      "reliability": "B"
+    },
+    {
+      "id": "foundation",
+      "labelAr": "Foundation",
+      "purposeAr": "بناء القاعدة المنخفضة والهارمونية وربط البيز بجسم التوزيع.",
+      "timingClass": "support",
+      "promptGuards": ["low density", "slow harmonic movement", "no attention-seeking contour"],
+      "prohibitions": ["lead melody", "vocal imitation", "ornamental runs"],
+      "reliability": "B"
+    },
+    {
+      "id": "groove",
+      "labelAr": "Groove",
+      "purposeAr": "تثبيت النبض والحركة وتوضيح بنية الأقسام.",
+      "timingClass": "continuous-variable",
+      "promptGuards": ["clear pulse", "section-aware fills", "space under vocal"],
+      "prohibitions": ["constant peak density", "fills without destination", "duplicate rhythmic function"],
+      "reliability": "B"
+    },
+    {
+      "id": "accompaniment",
+      "labelAr": "Accompaniment",
+      "purposeAr": "دعم الغناء هارمونيًا أو إيقاعيًا دون تقليد اللحن.",
+      "timingClass": "support",
+      "promptGuards": ["supports guide", "subordinate phrasing", "controlled density"],
+      "prohibitions": ["vocal melody doubling", "second lead", "continuous ornamentation"],
+      "reliability": "B"
+    },
+    {
+      "id": "pad-bed",
+      "labelAr": "Pad / Bed",
+      "purposeAr": "ملء الخلفية ببطء وإدارة العمق والاتساع.",
+      "timingClass": "sustained",
+      "promptGuards": ["slow attack", "controlled release", "sparse note changes", "section-limited use"],
+      "prohibitions": ["lead contour", "rhythmic pulse unless requested", "full-song continuous high bed"],
+      "reliability": "B"
+    },
+    {
+      "id": "fill",
+      "labelAr": "Fill",
+      "purposeAr": "جواب قصير داخل فراغ حقيقي بعد نهاية الجملة.",
+      "timingClass": "gap-only",
+      "entryRule": "after-complete-vocal-phrase",
+      "exitRule": "before-next-vocal-entry",
+      "maximumLengthBars": 2,
+      "promptGuards": ["one short answer", "intentional silence", "distinct from vocal melody"],
+      "prohibitions": ["continuous solo", "vocal overlap", "melody doubling", "unrelated accompaniment"],
+      "reliability": "B"
+    },
+    {
+      "id": "lazim",
+      "labelAr": "Lazim",
+      "purposeAr": "جملة هوية قصيرة مكتملة وقابلة للتكرار بين الأقسام أو داخل Hook.",
+      "timingClass": "motif",
+      "promptGuards": ["short", "memorable", "repeatable", "clear start and end", "maqam compatible"],
+      "prohibitions": ["vocal melody copy", "long solo", "unclear ending", "constant repetition"],
+      "reliability": "B"
+    },
+    {
+      "id": "counter-line",
+      "labelAr": "Counter Line",
+      "purposeAr": "خط مستقل يتحرك حول اللحن من دون منافسته.",
+      "timingClass": "intermittent-support",
+      "promptGuards": ["independent contour", "restricted register", "low density", "phrase-aware movement"],
+      "prohibitions": ["unison doubling", "second lead", "continuous movement under every word"],
+      "reliability": "B"
+    },
+    {
+      "id": "transition",
+      "labelAr": "Transition",
+      "purposeAr": "نقل المستمع إلى قسم جديد وتوجيه الحركة نحو حدث محدد.",
+      "timingClass": "boundary",
+      "promptGuards": ["short gesture", "clear destination", "ends on section boundary"],
+      "prohibitions": ["new theme", "long tail", "transition without destination"],
+      "reliability": "B"
+    },
+    {
+      "id": "lift",
+      "labelAr": "Lift",
+      "purposeAr": "رفع الكثافة أو الطاقة لفترة محددة في الذروة.",
+      "timingClass": "section-limited",
+      "promptGuards": ["controlled rise", "limited duration", "supports existing leader"],
+      "prohibitions": ["full-song activation", "new competing melody", "uncontrolled low-frequency buildup"],
+      "reliability": "B"
+    },
+    {
+      "id": "texture",
+      "labelAr": "Texture",
+      "purposeAr": "إضافة ملمس صوتي دون جملة موسيقية واضحة.",
+      "timingClass": "decorative",
+      "promptGuards": ["subtle", "non-melodic", "section-specific", "low attention"],
+      "prohibitions": ["lead melody", "obvious riser unless requested", "continuous masking layer"],
+      "reliability": "B"
+    }
+  ],
+  "invalidGenericDescriptions": [
+    "oriental instruments",
+    "full strings",
+    "arabic accompaniment",
+    "emotional orchestra",
+    "cinematic iraqi music"
+  ]
+}

data/knowledge/reliability.json

@@ -0,0 +1,53 @@
+{
+  "version": "0.1.0",
+  "updatedAt": "2026-07-20",
+  "levels": [
+    {
+      "id": "A",
+      "labelAr": "موثق رسميًا",
+      "descriptionAr": "وظيفة أو إجراء مثبت في وثائق المنتج الحالية ومسجل في evidence-registry.json.",
+      "requiresEvidence": true,
+      "decisionRule": "May be presented as an available product capability only when the evidence record is verified."
+    },
+    {
+      "id": "B",
+      "labelAr": "قاعدة هندسية ثابتة",
+      "descriptionAr": "مبدأ إنتاج أو هندسة صوت قابل للتكرار ولا يعتمد على نتيجة توليد واحدة.",
+      "requiresEvidence": false,
+      "decisionRule": "May be used as a workflow rule, warning or stage gate."
+    },
+    {
+      "id": "C",
+      "labelAr": "نتيجة توليدية",
+      "descriptionAr": "النتيجة تعتمد على فحص الملف الناتج؛ صحة البرومبت لا تثبت صلاحية التراك.",
+      "requiresEvidence": false,
+      "decisionRule": "Must require audition and accept/reject review before production use."
+    },
+    {
+      "id": "D",
+      "labelAr": "مرفوض",
+      "descriptionAr": "افتراض غير قابل للتحقق أو نتيجة لا تصلح للإنتاج.",
+      "requiresEvidence": false,
+      "decisionRule": "Must not pass a workflow gate."
+    },
+    {
+      "id": "A-PENDING",
+      "labelAr": "بانتظار التحقق الرسمي",
+      "descriptionAr": "ادعاء منسوب إلى وثائق رسمية لكن سجل المصدر غير مكتمل أو لم يراجع للإصدار الحالي.",
+      "requiresEvidence": true,
+      "decisionRule": "Must not be displayed as verified until its evidence status becomes verified."
+    }
+  ],
+  "generationPolicy": {
+    "reliability": "C",
+    "pipeline": [
+      "prompt",
+      "generation",
+      "solo-audition",
+      "context-audition",
+      "technical-inspection",
+      "accept-or-reject"
+    ],
+    "ruleAr": "لا يعتمد التراك لأن وصف البرومبت صحيح. يعتمد فقط بعد سماعه منفردًا وداخل التوزيع وفحصه فنيًا."
+  }
+}