engine-docs.manifest.json

{
  "repo": "CodeGateSoftware/keel",
  "ref": "latest-release",
  "refNote": "Sentinel, read by scripts/fetch-engine-docs.mjs (#85): resolve to the latest published release tag at build time, so the site describes what an operator actually runs. A literal branch, tag or SHA here is used verbatim instead. There is no fallback to main: if no tag resolves, the build fails.",
  "docs": [
    {
      "path": "docs/glossary.md",
      "slug": "glossary",
      "title": "Glossary",
      "en": "The single source for keel's vocabulary — every term a keel screen can show, defined here and nowhere else.",
      "ar": "المصدر الوحيد لمصطلحات كيل — كل مصطلح يمكن أن يعرضه سطر الأوامر معرَّفٌ هنا وحده.",
      "section": "reference",
      "fr": "L'unique source du vocabulaire de keel — chaque terme qu'un écran de keel peut afficher est défini ici, et nulle part ailleurs."
    },
    {
      "path": "docs/fiqh-basis.md",
      "slug": "fiqh-basis",
      "title": "The fiqh basis",
      "en": "The Shariah reasoning keel encodes, ruling by ruling, each with its in-repo source — published so it can be audited and challenged.",
      "ar": "الاستدلال الفقهي الذي يشفّره كيل، حكمًا حكمًا، مع مصدره داخل المستودع — نُشر ليُدقَّق ويُعترَض عليه.",
      "section": "reference",
      "fr": "Le raisonnement Shariah que keel encode, règle par règle, chacun avec sa source dans le dépôt — publié pour être audité et contesté."
    },
    {
      "path": "docs/architecture.md",
      "slug": "architecture",
      "title": "Software Architecture Record",
      "en": "The system as verified, not as imagined — what keel is, the packages it ships in, the choices holding it up, and, issue by issue, what is not built yet.",
      "ar": "النظامُ كما جرى التحقّقُ منه، لا كما يُتصوَّر — ما هو كيل، والحزمُ التي يُشحن بها، والقراراتُ الحاملةُ له، وما لم يُبْنَ بعدُ، مسألةً مسألةً.",
      "fr": "Le système tel qu'il est vérifié, non tel qu'on l'imagine — ce qu'est keel, les paquets qu'il livre, les choix qui le portent, et, ticket par ticket, ce qui n'est pas encore construit.",
      "section": "reference"
    },
    {
      "path": "docs/decisions/0001-desktop-update-path.md",
      "slug": "decision-0001-desktop-update-path",
      "title": "Decision 0001: the desktop update path",
      "en": "Why the desktop app never self-updates: updating means deliberately downloading the new installer — a trust posture chosen over an update channel that would itself need securing.",
      "ar": "لماذا لا يُحدِّث تطبيقُ سطح المكتب نفسَه أبدًا: التحديثُ يعني تنزيلَ المُثبِّت الجديد عن قصد — موقفُ ثقةٍ اختير على قناةِ تحديثٍ تحتاج هي نفسها إلى تحصين.",
      "section": "decisions",
      "fr": "Pourquoi l'application de bureau ne se met jamais à jour elle-même : la mise à jour passe par le téléchargement délibéré du nouvel installateur — une posture de confiance préférée à un canal de mise à jour qu'il faudrait lui-même sécuriser."
    },
    {
      "path": "docs/decisions/0002-sqlite-persistence.md",
      "slug": "decision-0002-sqlite-persistence",
      "title": "Decision 0002: SQLite persistence",
      "en": "Why persistence is SQLite with one writer per file — stated as load-bearing, not a limitation, with the named triggers that alone would reopen the question.",
      "ar": "لماذا هي مكانُ البيانات ‏SQLite بكاتبٍ واحد لكل ملف — قاعدةٌ حاملةٌ لا قيدًا مؤقتًا، مع مُحفِّزاتٍ مسمّاةٍ وحدها تفتح السؤالَ من جديد.",
      "section": "decisions",
      "fr": "Pourquoi la persistance est SQLite avec un seul écrivain par fichier — énoncé comme porteur et non comme limite, avec les déclencheurs nommés qui seuls rouvriraient la question."
    },
    {
      "path": "docs/decisions/0003-commands-layer-survey.md",
      "slug": "decision-0003-commands-layer-survey",
      "title": "Decision 0003: the commands-layer survey",
      "en": "The measurement-first survey of the commands layer — what each module's role is, and why \"larger than the engine\" dissolved before the survey ran.",
      "ar": "المسحُ القياسيُّ الأوّل لطبقة الأوامر — ما دورُ كلِّ وحدةٍ، ولماذا ذاب وصفُ «أكبر من المحرّك» قبل أن يبدأ المسح.",
      "section": "decisions",
      "fr": "L'enquête mesure-d'abord de la couche commands — le rôle de chaque module, et pourquoi « plus grande que le moteur » s'est dissous avant même que l'enquête ne commence."
    },
    {
      "path": "docs/decisions/0004-monetisation-not-now.md",
      "slug": "decision-0004-monetisation-not-now",
      "title": "Decision 0004: monetisation is not now",
      "en": "Why keel does not monetise yet, and why affiliate links are a permanent no rather than a “not yet”: referral revenue would be a direct stake in the same fee schedule keel's credibility depends on assessing without one.",
      "ar": "لماذا لا يُحصِّل كيل مالًا الآن، ولماذا روابطُ الإحالة رفضٌ دائمٌ لا «ليس بعد»: فعائدُ الإحالة حصّةٌ مباشرةٌ في جدول الرسوم نفسِه الذي تقوم مصداقيةُ كيل على تقييمه بلا مصلحةٍ فيه.",
      "fr": "Pourquoi keel ne se monétise pas maintenant, et pourquoi les liens d'affiliation sont un non définitif plutôt qu'un « pas encore » : un revenu de parrainage serait un intérêt direct dans le barème de frais que la crédibilité de keel repose sur sa capacité à évaluer sans intérêt.",
      "section": "decisions"
    },
    {
      "path": "docs/decisions/0005-options.md",
      "slug": "decision-0005-options",
      "title": "Decision 0005: options",
      "en": "Why keel does not trade options — refused on operational grounds, with the permissibility question expressly not reached, and the four facts that would reopen it.",
      "ar": "لماذا لا يتداول كيل الخيارات — رُفضت لأسبابٍ تشغيلية، مع الامتناع صراحةً عن الخوض في مسألة الجواز، والحقائق الأربع التي تعيد فتحها.",
      "fr": "Pourquoi keel ne négocie pas d'options — refusées pour des raisons opérationnelles, la question de la licéité n'étant expressément pas abordée, et les quatre faits qui la rouvriraient.",
      "section": "decisions"
    },
    {
      "path": "docs/desktop-install.md",
      "slug": "desktop-install",
      "title": "Installing the desktop app",
      "en": "Why your computer warns you about keel's desktop builds — unsigned, because code-signing certificates cost money the project doesn't have — what macOS and Windows each show, and the install path that draws no warning at all.",
      "ar": "لماذا يحذّرك حاسوبك من نسخ كيل لسطح المكتب — غير موقَّعة لأن شهادات التوقيع تكلف مالًا لا يملكه المشروع — وماذا يعرض كلٌّ من macOS وWindows، وطريقُ التثبيت الذي لا يثير أيّ تحذير.",
      "section": "guides",
      "fr": "Pourquoi votre ordinateur avertit au sujet des builds desktop de keel — non signées, car les certificats de signature coûtent un argent que le projet n'a pas — ce que macOS et Windows affichent chacun, et le chemin d'installation qui ne déclenche aucun avertissement."
    },
    {
      "path": "docs/operator-runbook.md",
      "slug": "operator-runbook",
      "title": "Operator runbook",
      "en": "Operating a deployment: the account-level obligations no rail can enforce, upgrades, and the three deployment profiles.",
      "ar": "تشغيل النشر: الالتزامات على مستوى الحساب التي لا يراها أي سكة أمان، والترقيات، وأنماط النشر الثلاثة.",
      "section": "guides",
      "fr": "Exploiter un déploiement : les obligations au niveau du compte qu'aucun garde-fou ne peut faire respecter, les mises à niveau et les trois profils de déploiement."
    },
    {
      "path": "docs/go-live-runbook.md",
      "slug": "go-live-runbook",
      "title": "Go-live runbook",
      "en": "The path to a first supervised live order — promotion, paper, and the human-in-the-loop steps.",
      "ar": "الطريق إلى أول أمر حقيقي خاضعٍ لإشراف بشري — الترقية، والتجريبي، وخطوات الإشراف.",
      "section": "guides",
      "fr": "Le chemin vers un premier ordre réel supervisé — promotion, papier et étapes soumises à une validation humaine."
    },
    {
      "path": "docs/mcp-server.md",
      "slug": "mcp-server",
      "title": "The read-only MCP server",
      "en": "keel mcp: the eight read-only tools an assistant can call — doctor, capabilities, profiles, orders, veto_log, purification, trials, reports — and the fence, in six walls, that keeps them read-only.",
      "ar": "‏keel mcp: الأدوات الثماني للقراءة فقط التي يستطيع المساعدُ الذكي استدعاءها — doctor وcapabilities وprofiles وorders وveto_log وpurification وtrials وreports — والسياجُ الذي يُبقيها للقراءة فقط.",
      "section": "reference",
      "fr": "keel mcp : les huit outils en lecture seule qu'un assistant peut appeler — doctor, capabilities, profiles, orders, veto_log, purification, trials, reports — et la clôture, en six murs, qui les garde en lecture seule."
    },
    {
      "path": "docs/research-toolkit.md",
      "slug": "research-toolkit",
      "title": "The research toolkit",
      "en": "The thirteen evidence modules keel research fronts — each with the question it answers and, to be read just as carefully, the question it refuses to answer.",
      "ar": "وحداتُ الأدلّةِ الثلاث عشرة التي يقف عليها أمرُ keel research — كلٌّ منها بالسؤال الذي تجيب عنه، وبالسؤال الذي ترفض الإجابةَ عنه، وهذا الثاني يُقرأ بالعناية نفسِها.",
      "fr": "Les treize modules de preuve que keel research met en façade — chacun avec la question à laquelle il répond et, à lire avec autant d'attention, celle à laquelle il refuse de répondre.",
      "section": "research"
    },
    {
      "path": "docs/experiments/2026-08-13-restated-under-a-production-faithful-engine.md",
      "slug": "experiment-honest-result-restated",
      "title": "Experiment: the honest result, restated",
      "en": "The full record of the measured result: no shipped rule family is net-positive at the taker fee actually paid — every number and the defects that forced a restatement.",
      "ar": "السجل الكامل للنتيجة المقيسة: لا عائلة قواعد مُصدَّرة تحقق ربحًا صافيًا عند رسوم الآخذ الفعلية — بكل أرقامها والعيوب التي فرضت إعادة البيان.",
      "section": "research",
      "fr": "Le compte rendu complet du résultat mesuré : aucune famille de règles livrée ne dégage un résultat net positif aux frais de preneur réellement payés — tous les chiffres, et les défauts qui ont imposé une rectification."
    },
    {
      "path": "docs/experiments/2026-08-11-hourly-backtest-turtle-breakout.md",
      "slug": "experiment-hourly-backtest",
      "title": "Experiment: the hourly backtest",
      "en": "Why the hourly profile exists: the same rules measured on ONE_HOUR bars fire 49.4 signals per asset-year instead of 2.15.",
      "ar": "لماذا يوجد النمط الساعي: القواعد نفسها على شموع الساعة تُطلق 49.4 إشارة لكل أصل-سنة بدل 2.15.",
      "section": "research",
      "fr": "Pourquoi le profil horaire existe : mesurées sur des bougies ONE_HOUR, les mêmes règles déclenchent 49,4 signaux par actif et par an, au lieu de 2,15."
    },
    {
      "path": "docs/experiments/2026-08-21-rule-family-significance.md",
      "slug": "experiment-rule-family-significance",
      "title": "Experiment: rule-family significance",
      "en": "Is any family's edge distinguishable from zero at the fee actually paid? Measured over every product's full cached history: none is, in any fee regime — the tool's job was to be able to say no, and it says no.",
      "ar": "هل تنفصل أفضليةُ أيِّ عائلةِ قواعد عن الصفر عند الرسوم المدفوعة فعلًا؟ قياسٌ على كامل التاريخ المخزَّن لكلِّ منتج: لا تنفصل أيٌّ منها في أيّ نظام رسوم — والغاية من الأداة أن تستطيع قولَ لا، فتقول لا.",
      "section": "research",
      "fr": "L'avantage d'une famille se distingue-t-il de zéro aux frais réellement payés ? Mesuré sur tout l'historique en cache de chaque produit : aucun ne s'en distingue, dans aucun régime de frais — le rôle de l'outil était de pouvoir dire non, et il dit non."
    },
    {
      "path": "docs/experiments/2026-08-22-optuna-parameter-study.md",
      "slug": "experiment-optuna-parameter-study",
      "title": "Experiment: the Optuna parameter study",
      "en": "An optimizer pointed at the rule families to see whether any candidate deserved the gauntlet: the promotion gate refused every cell, and the fitted winners were booked diagnostic-only — never auto-tuned lives.",
      "ar": "وجِّه مُحسِّنٌ نحو عائلات القواعد ليرى إن كان أيُّ مرشَّحٍ يستحقّ المسارَ العقابيّ: رفضت بوابةُ الترقية كلَّ خلية، وسُجِّل الفائزون المُواءَمون للتشخيص وحده — لا حياةً مضبوطةً آليًّا أبدًا.",
      "section": "research",
      "fr": "Un optimiseur pointé sur les familles de règles pour voir si un candidat méritait le parcours : le verrou de promotion a refusé chaque cellule, et les gagnants ajustés ont été consignés à titre de diagnostic uniquement — jamais des vies réglées automatiquement."
    },
    {
      "path": "docs/experiments/2026-08-22-trailing-vs-static-exits.md",
      "slug": "experiment-trailing-vs-static-exits",
      "title": "Experiment: trailing vs static exits",
      "en": "The ratchet-only exit policy — wired, then measured against static exits at the fee actually paid: trailing makes both families clearly worse, so the defaults stay off. The capability exists; the measurement says not to turn it on.",
      "ar": "سياسةُ الخروج ذاتُ السقّاطةِ وحدها — وُصِلت ثم قيست مقابل الخروج الثابت عند الرسوم المدفوعة فعلًا: التتبُّع يجعل العائلتين أسوأ بوضوح، فتبقى الإعدادات الافتراضية موقوفة. القدرةُ موجودة، والقياسُ يقول لا تُشغِلها.",
      "section": "research",
      "fr": "La politique de sortie à cliquet uniquement — câblée, puis mesurée face aux sorties statiques aux frais réellement payés : le trailing dégrade nettement les deux familles, donc les défauts restent désactivés. La capacité existe ; la mesure dit de ne pas l'activer."
    },
    {
      "path": "docs/research/2026-08-18-lahlou-speculation-risk-sources.md",
      "slug": "research-lahlou-speculation-risk",
      "title": "Research: speculation risk sources (Lahlou)",
      "en": "Source review on the risk sources of speculation — part of the research corpus behind the fiqh basis.",
      "ar": "مراجعة مصادر حول منابع خطر المضاربة — من سجل البحث الذي يقف خلف الأساس الفقهي.",
      "section": "research",
      "fr": "Revue de littérature sur les origines du risque dans la spéculation — un pan du corpus de recherche qui sous-tend la base fiqh."
    },
    {
      "path": "docs/research/2026-08-18-money-management-and-fiqh-source-review.md",
      "slug": "research-money-management",
      "title": "Research: money management & fiqh sources",
      "en": "Source review on money management in trading and its fiqh treatment.",
      "ar": "مراجعة مصادر حول إدارة المال في التداول ومعالجتها الفقهية.",
      "section": "research",
      "fr": "Revue de littérature sur la gestion de l'argent dans le trading et son traitement en fiqh."
    }
  ],
  "sections": [
    {
      "id": "get-started",
      "en": "Get started",
      "ar": "البداية",
      "fr": "Premiers pas"
    },
    {
      "id": "guides",
      "en": "Guides",
      "ar": "أدلة",
      "fr": "Guides"
    },
    {
      "id": "reference",
      "en": "Reference",
      "ar": "مرجع",
      "fr": "Référence"
    },
    {
      "id": "decisions",
      "en": "Decisions",
      "ar": "سجلّات القرارات",
      "fr": "Décisions"
    },
    {
      "id": "research",
      "en": "Research & experiments",
      "ar": "البحث والتجارب",
      "fr": "Recherche et expériences"
    }
  ]
}