28e57ab2b5
Golden Path — Partner Tier-1 verification flow:
POST /api/v1/golden-path/run — executes complete partner lifecycle:
1. PartnerDossier (structured output with Provenance)
2. EconomicsModel (revenue_upside, cost, payback, sensitivity)
3. ApprovalPacket (Class B enforcement, SLA, creates ApprovalRequest)
4. EvidencePack (auto-assembled from steps 1-3, SHA256 hash)
All steps linked by trace_id for end-to-end correlation.
This is the FIRST flow that actually uses structured_outputs.py
schemas in live code — PartnerDossier, EconomicsModel, ApprovalPacket
all enforced with Pydantic validation + Provenance fields.
correlation_id propagation:
OpenClaw gateway now generates/accepts correlation_id and injects
it into payload as _correlation_id. Returned in all responses.
This enables trace linking across decision → approval → execution.
NEXT_STEP_AND_STACK_RECOMMENDATIONS_AR.md:
Comprehensive next-step guide covering:
- 6 closure tests (truth, schema, workflow, trust, release, executive)
- Stack additions now (OTel, OIDC, attestations, OpenFGA)
- Stack additions next (Great Expectations, Unstructured, connectors)
- Backend/frontend/docs upgrade priorities
- 7-step optimal execution order
- Avoid-now list
https://claude.ai/code/session_01W1rJthWDkasijTdXCfxVHs
6.9 KiB
الخطوة التالية + توصيات المكدس — NEXT STEP & STACK RECOMMENDATIONS
القاعدة: Core System = done. الآن = Live Path + Enforcement + Release Gate.
المرجع:MASTER_OPERATING_PROMPT.md+tier1-master-closure-checklist.md
الخطوة التالية الواحدة الآن
أغلق المسار الذهبي end-to-end
Partner intake → Partner dossier (PartnerDossier schema)
→ Economics model (EconomicsModel schema)
→ Approval packet (ApprovalPacket schema)
→ Approval Center (Class B enforcement)
→ Workflow commitment (DurableTaskFlow checkpoint)
→ Evidence pack (auto-assembled, SHA256)
→ Executive weekly summary (ExecWeeklyPack schema)
لماذا هذا المسار؟
- يختبر القرار + الثقة + التنفيذ + الواجهة في تشغيل واحد
- أسرع wedge لإظهار قيمة حقيقية
- يثبت 5 من 6 اختبارات الإغلاق (truth, schema, workflow, trust, executive)
6 اختبارات الإغلاق
| # | الاختبار | المعيار | الحالة |
|---|---|---|---|
| 1 | Truth | مصدر واحد للحقيقة يحدد current/partial/pilot/production | PASS — current-vs-target-register.md |
| 2 | Schema | كل output حرج schema-bound مع validation | FAIL — 17 schemas defined, 0 enforced |
| 3 | Workflow | مسار حي واحد end-to-end بدون تعديل يدوي | FAIL — لا يوجد مسار مكتمل |
| 4 | Trust | external commitment يفشل بدون approval + evidence + correlation | PARTIAL — policy gate موجود، enforcement غير مكتمل |
| 5 | Release | Release Readiness Matrix توقف الإصدار فعلاً | FAIL — architecture_brief في CI لكن ليس gate |
| 6 | Executive | Executive Room حية تُستخدم أسبوعياً | PARTIAL — مربوطة بـ API، لكن بحاجة بيانات + استخدام |
أضف الآن — Stack Additions
1. OpenTelemetry (correlation)
لماذا: ربط trace_id/span_id عبر approval → execution → evidence
كيف: إضافة opentelemetry-api + opentelemetry-sdk لـ requirements.txt
أين: openclaw/gateway.py — generate trace_id at entry, propagate downstream
الأثر: كل قرار قابل للتتبع من البداية للنهاية
2. GitHub OIDC
لماذا: استبدال long-lived secrets بـ short-lived tokens
كيف: في .github/workflows/dealix-ci.yml — إضافة permissions: id-token: write
أين: deploy steps + cloud access
الأثر: أمان أفضل + compliance ready
3. Artifact Attestations
لماذا: إثبات provenance لكل build
كيف: actions/attest-build-provenance@v1 في CI
متطلب: GitHub Enterprise Cloud لـ private repos
الأثر: كل artifact مربوط بـ commit SHA + workflow + environment
4. OpenFGA (أقل تكامل حي)
لماذا: object-level authorization لمسار approval/evidence
كيف: ابدأ بـ authorization_model_id pinned لمسار واحد
أين: approval_bridge.py — check can_user_approve(resource)
الأثر: صلاحيات دقيقة بدل RBAC عام
أضف بعده مباشرة
5. Great Expectations (data quality)
لماذا: جودة البيانات كجزء من workflow preconditions
أين: قبل evidence pack assembly + forecast calculations
الأثر: بيانات موثوقة في Executive Room
6. Connector Governance Layer
لماذا: فرض contract موحد لكل connector
ما المطلوب: version, timeout, retry, health, freshness, audit mapping
الأثر: لا direct vendor bindings من agents
7. Unstructured (document extraction)
لماذا: استخراج DD docs, contracts, CIMs, PDFs
متى: عند تفعيل M&A DD workflow
الأثر: evidence pipeline أقوى
احتفظ به في الرادار (لا تضفه الآن)
| التقنية | السبب | متى |
|---|---|---|
| Temporal | durable workflows | بعد نجاح المسار الذهبي |
| OPA | policy engine | عندما تتجاوز القواعد 50 |
| MCP expansion | tool connectors كثيرة | بعد استقرار المسارات الأولى |
| Airbyte | data ingestion | عند 5+ مصادر بيانات |
Backend Upgrades — الترتيب
الآن
- correlation_id propagation:
openclaw/gateway.py→ agent → audit → evidence - Schema enforcement: LeadScoreCard + ApprovalPacket في live flows
- Auto evidence pack: on deal close → assemble from 6 tables
- Approval enforcement: Class B actions MUST have ApprovalPacket schema
بعده
- Idempotency keys: لكل endpoint يسبب side effects
- Retry/compensation: لمسارات الشراكة والتوقيع
- Verification receipts: لكل tool call عبر OpenClaw
- Telemetry: structured logs + approval SLA metrics + contradiction counters
Frontend Upgrades — الترتيب
الآن
- Contract-driven rendering: Executive Room يستهلك ExecWeeklyPack مباشرة
- Loading/empty/error states: لكل surface
- Demo vs live indicator: فصل واضح
بعده
- Arabic/RTL polish: جداول، تقارير، تصدير
- Print/export modes: للواجهات التنفيذية
- State badges: severity + trust indicators
Docs/Sales/Marketing Additions — الترتيب
الآن
- Customer onboarding guide (pilot clients)
- Admin setup guide (IT team)
- Executive quickstart (CEO first use)
- Pilot sales pack: one-pager + deck + ROI + scope
- Marketer hub: positioning + ICPs + objection handling + claims allowed
بعده
- Operator guide
- Implementation checklist
- Trust/compliance page (public)
- Saudi/GCC readiness page (public)
- Industry use-case pages
الترتيب الأمثل — 7 خطوات
1. فعّل Docs/Governance/Contracts CI بالكامل ✅ (architecture_brief في CI)
2. أغلق المسار الذهبي end-to-end ← الآن
3. حوّل Executive Room إلى contract-driven
4. اجعل Release Readiness Matrix gate فعلية
5. فعّل workflow سعودي حساس واحد
6. أضف OpenTelemetry + OIDC + attestations
7. جهّز pilot sales pack + marketer hub + customer docs
تجنب الآن
| ما تتجنبه | السبب |
|---|---|
| إضافة agents جديدة | agent sprawl قبل القيمة |
| MCP heavy expansion | تعقيد قبل استقرار |
| Temporal قبل المسار الذهبي | over-engineering |
| Industry pages قبل pilot | لا عميل = لا case study |
| Perfect CI قبل المنتج | CI يُصلح لاحقاً، المنتج أولاً |