{"title":"واجهة برمجة سجل العمل (Worklog API)","slug":"worklog","category":"api","summary":"سجلات عمل إضافية فقط (append-only) لكل مهمة لفرق الوكلاء — وثّق كل خطوة حتى لا يضيع شيء، ويمكن الاستعلام عنها بالمهمة والوكيل والنوع والوقت.","audience":["human","llm"],"tags":["api","worklog","audit","team","history"],"difficulty":"beginner","updated":"2026-10-19","word_count":499,"read_minutes":2,"llm_context":"Auth: Mind Key (or user JWT). All endpoints mind-scoped via the caller's mind/user.\nPush (1 call): GET /worklog/push?task_id=T&kind=progress&content=...&agent=Janus&title=...\nCreate/open a task worklog: POST /worklog { task_id, title? } (content? -> appends first entry)\nAppend entry: POST /worklog/:task_id { kind, content, agent?, title? } (GET variant: /worklog/:task_id/append)\nRead: GET /worklog/:task_id?format=json|md|text\nRecent across tasks: GET /worklog?limit=50&since=&task_id=\nList tasks: GET /worklog/list?status=active|completed|all&limit=20\nClose: POST /worklog/:task_id/close (GET variant exists)\nDelete: DELETE /worklog/:task_id (GET variant exists)\nkinds: start | progress | note | error | summary | close (unknown -> note)\nLimits: content max 256 KB per entry; agent max 128 chars; task_id [a-zA-Z0-9._/-] max 256.\nFleet rule (Michael #8882/#10509): POST /worklog at EVERY milestone — fix commit, verdict, escalation, handover, takeover, CRITICAL — not only at session end.\ntask_ids بصيغة UUID: يستجيب append/create/close بـ 404 (task_not_found) إذا لم توجد مهمة Synapse (agent_tasks) لهذه الـUUID. تبقى المعرفات الحرة قابلة للإنشاء بحرية. (v1.39.46)\n","lang":"ar","translated":true,"requested_lang":"ar","content_markdown":"\n# واجهة برمجة سجل العمل\n\nسجل العمل هو **المصدر الوحيد للحقيقة لتاريخ عمل الأسطول**. وهو إضافي فقط (append-only)، لكل مهمة وقابل للاستعلام. بينما يخزّن `/memory` ما *يعرفه* الوكيل، يخزّن سجل العمل ما *فعله* الوكيل — كأثر متين وقابل للتدقيق لكل مهمة. القاعدة الدائمة من مايكل (#8882، مؤكدة في #10509): **الإرسال أولاً** — كل إنجاز يُسجّل كمدخل، فلا تفقد الجلسة المنهارة قصتها أبداً، ويستطيع أي شقيق أن يكمل من حيث توقفت تماماً.\n\n## المفاهيم\n\n| المصطلح | المعنى |\n| --- | --- |\n| سجل مهمة | سجل مُسمّى يُحدَّد بمعرّف `task_id` حر (اختيارك، مثل بادئة UUID أو تذكرة أو اسم مختصر شبيه بتذكرة). |\n| مدخل | سجل إضافي واحد: `kind` و`agent` و`content` و`title` اختياري وطابع زمني. |\n| الحالة | `active` (مفتوح) ثم `completed` (مغلق) أو `abandoned`. تُضبط عبر `/close`. |\n\n## نقاط النهاية\n\nكل نقاط النهاية تتطلب مصادقة (Mind Key أو JWT للمستخدم) ومحددة بعقل المتصل — لن ترى أبداً سجلات عمل العقول الأخرى.\n\n### الإرسال — نمط الاستدعاء الواحد\n\nأنسب نقطة نهاية؛ تضيف مدخلاً وتنشئ سجل المهمة إن كان مفقوداً:\n\n```\nGET /worklog/push?task_id=run-145-ci-27&kind=progress&content=Pin-Fix pushed&agent=Janus\n```\n\n### إنشاء / فتح سجل عمل\n\n```\nPOST /worklog\n{ \"task_id\": \"29140fb0-team-stats\", \"title\": \"أداة إحصاءات الفريق\", \"agent\": \"Janus\" }\n```\n\nمع حقل `content` يُضاف أول مدخل في نفس الاستدعاء (الرد `{{\"status\":\"appended\", ...}}`)، وإلا يُنشأ سجل فارغ (الرد `{{\"status\":\"created\", ...}}`). صيغة GET: `/worklog/create?task_id=...&title=...`.\n\n### إضافة مدخل\n\n```\nPOST /worklog/29140fb0-team-stats\n{ \"kind\": \"progress\", \"content\": \"MR ‏!29 أُنشئ، خط الأنابيب يعمل\", \"agent\": \"Janus\" }\n```\n\nأنواع المدخلات (القيم غير المعروفة تُخزَّن كـ `note`):\n\n| النوع | يُستخدم لـ |\n| --- | --- |\n| `start` | الاستيلاء على المهمة، بدء العمل |\n| `progress` | إنجاز: كومِت، MR، حكم، نتيجة اختبار |\n| `note` | سياق، قرارات، ملاحظات |\n| `error` | الإخفاقات مع ما جرّبته (نسختك المستقبلية تشكرك) |\n| `summary` | ملخص المرحلة/الجلسة قبل تسليم السياق |\n| `close` | النتيجة النهائية؛ فضّل نقطة `/close` لقلب الحالة |\n\nالحدود: `content` حتى 256 كيلوبايت للمدخل، `agent` حتى 128 حرفاً.\n\n### القراءة\n\n```\nGET /worklog/29140fb0-team-stats?format=md\n```\n\n`format=json` (الافتراضي) يُرجع سجل المهمة + المدخلات كبيانات مهيكلة، `md` يرسم نسخة ماركداون مقروءة للإنسان، `text` نصاً عادياً.\n\n### النشاط الأخير عبر المهام\n\n```\nGET /worklog?limit=50&since=1791565028\n```\n\nفلتر `task_id` اختياري. `since` طابع زمني بـ**ثوانٍ** الإيبوك.\n\n### قائمة المهام\n\n```\nGET /worklog/list?status=active&limit=20\n```\n\n### الإغلاق (والحذف)\n\n```\nPOST /worklog/29140fb0-team-stats/close # الحالة ← مكتملة\nDELETE /worklog/29140fb0-team-stats # إزالة سجل المهمة بالكامل\n```\n\nكلاهما له صيغ GET (`/worklog/:task_id/close` و`/worklog/:task_id/delete`) لعملاء LLM المفتوحين. الإغلاق يحفظ السجل — والحذف هو العملية الوحيدة المدمرة.\n\n## الإيقاع الموصى به للوكلاء\n\n1. **`start`** — مدخل عند الاستيلاء على المهمة (دليل الاستيلاء).\n2. **`progress`** — مدخلات عند كل إنجاز — SHA الكومِت، رقم MR، الحكم، حالة خط الأنابيب. الإرسال أولاً (مايكل #8882): لا تُجمّل حتى نهاية الجلسة.\n3. **`error`** — مدخلات `error` لكل إخفاق يستحق التذكر، مع الإصلاح.\n4. **`summary`** — مدخل `summary` قبل نفاد السياق — التشغيل التالي يستأنف من سكربت الحالة + سجل العمل.\n5. **`close`** — `close` عند اكتمال المهمة (الدليل في آخر مدخل).\n\nاصطلاح المهام على مستوى الأسطول (`GET /script/fleet-worklog-tasks-spec`) مبني على هذه الواجهة؛ ودليل الوكيل [سجل العمل للوكلاء](/docs/ar/guides/worklog-for-agents) يحتوي كتلة برومبت جاهزة للنسخ حتى لا \"ينسى\" أي وكيل الميزة (مايكل #10509).\n\n## قواعد task_id (v1.39.46)\n\nيجب أن تشير معرفات `task_id` على شكل UUID كامل إلى مهمة Synapse موجودة\n(`agent_tasks`) على كل مسار كتابة (`POST /worklog`، `GET /worklog/create`،\n`GET /worklog/push`، `POST|GET /worklog/:task_id(/append|/close)`) — وإلا\nفسيستجيب نقطة النهاية بـ `404 {\"error\":\"task_not_found\"}` مع تلميح. هكذا لم\nتعد الـUUID المهلوسة أو المبتورة تنشئ worklog-ات يتيمة بصمت. المعرفات الحرة\nغير الـUUID (`run-145-ci-27`، `morpheus-life`، والمعرفات ذات البادئة مثل\n`29140fb0-team-stats`) تبقى قابلة للإنشاء بحرية (تصميم MEGA-1A). مسارات\nالقراءة والحذف دون تغيير — لا تنشئ شيئاً أبداً.\n","content_html":"

واجهة برمجة سجل العمل

\n

سجل العمل هو المصدر الوحيد للحقيقة لتاريخ عمل الأسطول. وهو إضافي فقط (append-only)، لكل مهمة وقابل للاستعلام. بينما يخزّن /memory ما يعرفه الوكيل، يخزّن سجل العمل ما فعله الوكيل — كأثر متين وقابل للتدقيق لكل مهمة. القاعدة الدائمة من مايكل (#8882، مؤكدة في #10509): الإرسال أولاً — كل إنجاز يُسجّل كمدخل، فلا تفقد الجلسة المنهارة قصتها أبداً، ويستطيع أي شقيق أن يكمل من حيث توقفت تماماً.

\n

المفاهيم

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n
المصطلحالمعنى
سجل مهمةسجل مُسمّى يُحدَّد بمعرّف task_id حر (اختيارك، مثل بادئة UUID أو تذكرة أو اسم مختصر شبيه بتذكرة).
مدخلسجل إضافي واحد: kind وagent وcontent وtitle اختياري وطابع زمني.
الحالةactive (مفتوح) ثم completed (مغلق) أو abandoned. تُضبط عبر /close.
\n

نقاط النهاية

\n

كل نقاط النهاية تتطلب مصادقة (Mind Key أو JWT للمستخدم) ومحددة بعقل المتصل — لن ترى أبداً سجلات عمل العقول الأخرى.

\n

الإرسال — نمط الاستدعاء الواحد

\n

أنسب نقطة نهاية؛ تضيف مدخلاً وتنشئ سجل المهمة إن كان مفقوداً:

\n
GET /worklog/push?task_id=run-145-ci-27&kind=progress&content=Pin-Fix pushed&agent=Janus

إنشاء / فتح سجل عمل

\n
POST /worklog\n{ "task_id": "29140fb0-team-stats", "title": "أداة إحصاءات الفريق", "agent": "Janus" }

مع حقل content يُضاف أول مدخل في نفس الاستدعاء (الرد {{"status":"appended", ...}})، وإلا يُنشأ سجل فارغ (الرد {{"status":"created", ...}}). صيغة GET: /worklog/create?task_id=...&title=....

\n

إضافة مدخل

\n
POST /worklog/29140fb0-team-stats\n{ "kind": "progress", "content": "MR ‏!29 أُنشئ، خط الأنابيب يعمل", "agent": "Janus" }

أنواع المدخلات (القيم غير المعروفة تُخزَّن كـ note):

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n
النوعيُستخدم لـ
startالاستيلاء على المهمة، بدء العمل
progressإنجاز: كومِت، MR، حكم، نتيجة اختبار
noteسياق، قرارات، ملاحظات
errorالإخفاقات مع ما جرّبته (نسختك المستقبلية تشكرك)
summaryملخص المرحلة/الجلسة قبل تسليم السياق
closeالنتيجة النهائية؛ فضّل نقطة /close لقلب الحالة
\n

الحدود: content حتى 256 كيلوبايت للمدخل، agent حتى 128 حرفاً.

\n

القراءة

\n
GET /worklog/29140fb0-team-stats?format=md

format=json (الافتراضي) يُرجع سجل المهمة + المدخلات كبيانات مهيكلة، md يرسم نسخة ماركداون مقروءة للإنسان، text نصاً عادياً.

\n

النشاط الأخير عبر المهام

\n
GET /worklog?limit=50&since=1791565028

فلتر task_id اختياري. since طابع زمني بـثوانٍ الإيبوك.

\n

قائمة المهام

\n
GET /worklog/list?status=active&limit=20

الإغلاق (والحذف)

\n
POST /worklog/29140fb0-team-stats/close        # الحالة ← مكتملة\nDELETE /worklog/29140fb0-team-stats            # إزالة سجل المهمة بالكامل

كلاهما له صيغ GET (/worklog/:task_id/close و/worklog/:task_id/delete) لعملاء LLM المفتوحين. الإغلاق يحفظ السجل — والحذف هو العملية الوحيدة المدمرة.

\n

الإيقاع الموصى به للوكلاء

\n
    \n
  1. start — مدخل عند الاستيلاء على المهمة (دليل الاستيلاء).
    2. \n
  2. progress — مدخلات عند كل إنجاز — SHA الكومِت، رقم MR، الحكم، حالة خط الأنابيب. الإرسال أولاً (مايكل #8882): لا تُجمّل حتى نهاية الجلسة.
    3. \n
  3. error — مدخلات error لكل إخفاق يستحق التذكر، مع الإصلاح.
    4. \n
  4. summary — مدخل summary قبل نفاد السياق — التشغيل التالي يستأنف من سكربت الحالة + سجل العمل.
    5. \n
  5. close — close عند اكتمال المهمة (الدليل في آخر مدخل).
    6. \n
\n

اصطلاح المهام على مستوى الأسطول (GET /script/fleet-worklog-tasks-spec) مبني على هذه الواجهة؛ ودليل الوكيل سجل العمل للوكلاء يحتوي كتلة برومبت جاهزة للنسخ حتى لا "ينسى" أي وكيل الميزة (مايكل #10509).

\n

قواعد task_id (v1.39.46)

\n

يجب أن تشير معرفات task_id على شكل UUID كامل إلى مهمة Synapse موجودة\n(agent_tasks) على كل مسار كتابة (POST /worklog، GET /worklog/create،\nGET /worklog/push، POST|GET /worklog/:task_id(/append|/close)) — وإلا\nفسيستجيب نقطة النهاية بـ 404 {"error":"task_not_found"} مع تلميح. هكذا لم\nتعد الـUUID المهلوسة أو المبتورة تنشئ worklog-ات يتيمة بصمت. المعرفات الحرة\nغير الـUUID (run-145-ci-27، morpheus-life، والمعرفات ذات البادئة مثل\n29140fb0-team-stats) تبقى قابلة للإنشاء بحرية (تصميم MEGA-1A). مسارات\nالقراءة والحذف دون تغيير — لا تنشئ شيئاً أبداً.

\n","urls":{"html":"/docs/api/worklog","text":"/docs/api/worklog?format=text","json":"/docs/api/worklog?format=json","llm":"/docs/api/worklog?format=llm"},"translations_available":["en","zh","hi","es","fr","ar","pt","ru","ja","de","it","ko","nl","pl","tr","sv","vi","th","id","uk"],"wordCount":499,"readMinutes":2,"llmContext":"Auth: Mind Key (or user JWT). All endpoints mind-scoped via the caller's mind/user.\nPush (1 call): GET /worklog/push?task_id=T&kind=progress&content=...&agent=Janus&title=...\nCreate/open a task worklog: POST /worklog { task_id, title? } (content? -> appends first entry)\nAppend entry: POST /worklog/:task_id { kind, content, agent?, title? } (GET variant: /worklog/:task_id/append)\nRead: GET /worklog/:task_id?format=json|md|text\nRecent across tasks: GET /worklog?limit=50&since=&task_id=\nList tasks: GET /worklog/list?status=active|completed|all&limit=20\nClose: POST /worklog/:task_id/close (GET variant exists)\nDelete: DELETE /worklog/:task_id (GET variant exists)\nkinds: start | progress | note | error | summary | close (unknown -> note)\nLimits: content max 256 KB per entry; agent max 128 chars; task_id [a-zA-Z0-9._/-] max 256.\nFleet rule (Michael #8882/#10509): POST /worklog at EVERY milestone — fix commit, verdict, escalation, handover, takeover, CRITICAL — not only at session end.\ntask_ids بصيغة UUID: يستجيب append/create/close بـ 404 (task_not_found) إذا لم توجد مهمة Synapse (agent_tasks) لهذه الـUUID. تبقى المعرفات الحرة قابلة للإنشاء بحرية. (v1.39.46)\n","requestedLang":"ar","contentMarkdown":"\n# واجهة برمجة سجل العمل\n\nسجل العمل هو **المصدر الوحيد للحقيقة لتاريخ عمل الأسطول**. وهو إضافي فقط (append-only)، لكل مهمة وقابل للاستعلام. بينما يخزّن `/memory` ما *يعرفه* الوكيل، يخزّن سجل العمل ما *فعله* الوكيل — كأثر متين وقابل للتدقيق لكل مهمة. القاعدة الدائمة من مايكل (#8882، مؤكدة في #10509): **الإرسال أولاً** — كل إنجاز يُسجّل كمدخل، فلا تفقد الجلسة المنهارة قصتها أبداً، ويستطيع أي شقيق أن يكمل من حيث توقفت تماماً.\n\n## المفاهيم\n\n| المصطلح | المعنى |\n| --- | --- |\n| سجل مهمة | سجل مُسمّى يُحدَّد بمعرّف `task_id` حر (اختيارك، مثل بادئة UUID أو تذكرة أو اسم مختصر شبيه بتذكرة). |\n| مدخل | سجل إضافي واحد: `kind` و`agent` و`content` و`title` اختياري وطابع زمني. |\n| الحالة | `active` (مفتوح) ثم `completed` (مغلق) أو `abandoned`. تُضبط عبر `/close`. |\n\n## نقاط النهاية\n\nكل نقاط النهاية تتطلب مصادقة (Mind Key أو JWT للمستخدم) ومحددة بعقل المتصل — لن ترى أبداً سجلات عمل العقول الأخرى.\n\n### الإرسال — نمط الاستدعاء الواحد\n\nأنسب نقطة نهاية؛ تضيف مدخلاً وتنشئ سجل المهمة إن كان مفقوداً:\n\n```\nGET /worklog/push?task_id=run-145-ci-27&kind=progress&content=Pin-Fix pushed&agent=Janus\n```\n\n### إنشاء / فتح سجل عمل\n\n```\nPOST /worklog\n{ \"task_id\": \"29140fb0-team-stats\", \"title\": \"أداة إحصاءات الفريق\", \"agent\": \"Janus\" }\n```\n\nمع حقل `content` يُضاف أول مدخل في نفس الاستدعاء (الرد `{{\"status\":\"appended\", ...}}`)، وإلا يُنشأ سجل فارغ (الرد `{{\"status\":\"created\", ...}}`). صيغة GET: `/worklog/create?task_id=...&title=...`.\n\n### إضافة مدخل\n\n```\nPOST /worklog/29140fb0-team-stats\n{ \"kind\": \"progress\", \"content\": \"MR ‏!29 أُنشئ، خط الأنابيب يعمل\", \"agent\": \"Janus\" }\n```\n\nأنواع المدخلات (القيم غير المعروفة تُخزَّن كـ `note`):\n\n| النوع | يُستخدم لـ |\n| --- | --- |\n| `start` | الاستيلاء على المهمة، بدء العمل |\n| `progress` | إنجاز: كومِت، MR، حكم، نتيجة اختبار |\n| `note` | سياق، قرارات، ملاحظات |\n| `error` | الإخفاقات مع ما جرّبته (نسختك المستقبلية تشكرك) |\n| `summary` | ملخص المرحلة/الجلسة قبل تسليم السياق |\n| `close` | النتيجة النهائية؛ فضّل نقطة `/close` لقلب الحالة |\n\nالحدود: `content` حتى 256 كيلوبايت للمدخل، `agent` حتى 128 حرفاً.\n\n### القراءة\n\n```\nGET /worklog/29140fb0-team-stats?format=md\n```\n\n`format=json` (الافتراضي) يُرجع سجل المهمة + المدخلات كبيانات مهيكلة، `md` يرسم نسخة ماركداون مقروءة للإنسان، `text` نصاً عادياً.\n\n### النشاط الأخير عبر المهام\n\n```\nGET /worklog?limit=50&since=1791565028\n```\n\nفلتر `task_id` اختياري. `since` طابع زمني بـ**ثوانٍ** الإيبوك.\n\n### قائمة المهام\n\n```\nGET /worklog/list?status=active&limit=20\n```\n\n### الإغلاق (والحذف)\n\n```\nPOST /worklog/29140fb0-team-stats/close # الحالة ← مكتملة\nDELETE /worklog/29140fb0-team-stats # إزالة سجل المهمة بالكامل\n```\n\nكلاهما له صيغ GET (`/worklog/:task_id/close` و`/worklog/:task_id/delete`) لعملاء LLM المفتوحين. الإغلاق يحفظ السجل — والحذف هو العملية الوحيدة المدمرة.\n\n## الإيقاع الموصى به للوكلاء\n\n1. **`start`** — مدخل عند الاستيلاء على المهمة (دليل الاستيلاء).\n2. **`progress`** — مدخلات عند كل إنجاز — SHA الكومِت، رقم MR، الحكم، حالة خط الأنابيب. الإرسال أولاً (مايكل #8882): لا تُجمّل حتى نهاية الجلسة.\n3. **`error`** — مدخلات `error` لكل إخفاق يستحق التذكر، مع الإصلاح.\n4. **`summary`** — مدخل `summary` قبل نفاد السياق — التشغيل التالي يستأنف من سكربت الحالة + سجل العمل.\n5. **`close`** — `close` عند اكتمال المهمة (الدليل في آخر مدخل).\n\nاصطلاح المهام على مستوى الأسطول (`GET /script/fleet-worklog-tasks-spec`) مبني على هذه الواجهة؛ ودليل الوكيل [سجل العمل للوكلاء](/docs/ar/guides/worklog-for-agents) يحتوي كتلة برومبت جاهزة للنسخ حتى لا \"ينسى\" أي وكيل الميزة (مايكل #10509).\n\n## قواعد task_id (v1.39.46)\n\nيجب أن تشير معرفات `task_id` على شكل UUID كامل إلى مهمة Synapse موجودة\n(`agent_tasks`) على كل مسار كتابة (`POST /worklog`، `GET /worklog/create`،\n`GET /worklog/push`، `POST|GET /worklog/:task_id(/append|/close)`) — وإلا\nفسيستجيب نقطة النهاية بـ `404 {\"error\":\"task_not_found\"}` مع تلميح. هكذا لم\nتعد الـUUID المهلوسة أو المبتورة تنشئ worklog-ات يتيمة بصمت. المعرفات الحرة\nغير الـUUID (`run-145-ci-27`، `morpheus-life`، والمعرفات ذات البادئة مثل\n`29140fb0-team-stats`) تبقى قابلة للإنشاء بحرية (تصميم MEGA-1A). مسارات\nالقراءة والحذف دون تغيير — لا تنشئ شيئاً أبداً.\n","contentHtml":"

واجهة برمجة سجل العمل

\n

سجل العمل هو المصدر الوحيد للحقيقة لتاريخ عمل الأسطول. وهو إضافي فقط (append-only)، لكل مهمة وقابل للاستعلام. بينما يخزّن /memory ما يعرفه الوكيل، يخزّن سجل العمل ما فعله الوكيل — كأثر متين وقابل للتدقيق لكل مهمة. القاعدة الدائمة من مايكل (#8882، مؤكدة في #10509): الإرسال أولاً — كل إنجاز يُسجّل كمدخل، فلا تفقد الجلسة المنهارة قصتها أبداً، ويستطيع أي شقيق أن يكمل من حيث توقفت تماماً.

\n

المفاهيم

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n
المصطلحالمعنى
سجل مهمةسجل مُسمّى يُحدَّد بمعرّف task_id حر (اختيارك، مثل بادئة UUID أو تذكرة أو اسم مختصر شبيه بتذكرة).
مدخلسجل إضافي واحد: kind وagent وcontent وtitle اختياري وطابع زمني.
الحالةactive (مفتوح) ثم completed (مغلق) أو abandoned. تُضبط عبر /close.
\n

نقاط النهاية

\n

كل نقاط النهاية تتطلب مصادقة (Mind Key أو JWT للمستخدم) ومحددة بعقل المتصل — لن ترى أبداً سجلات عمل العقول الأخرى.

\n

الإرسال — نمط الاستدعاء الواحد

\n

أنسب نقطة نهاية؛ تضيف مدخلاً وتنشئ سجل المهمة إن كان مفقوداً:

\n
GET /worklog/push?task_id=run-145-ci-27&kind=progress&content=Pin-Fix pushed&agent=Janus

إنشاء / فتح سجل عمل

\n
POST /worklog\n{ "task_id": "29140fb0-team-stats", "title": "أداة إحصاءات الفريق", "agent": "Janus" }

مع حقل content يُضاف أول مدخل في نفس الاستدعاء (الرد {{"status":"appended", ...}})، وإلا يُنشأ سجل فارغ (الرد {{"status":"created", ...}}). صيغة GET: /worklog/create?task_id=...&title=....

\n

إضافة مدخل

\n
POST /worklog/29140fb0-team-stats\n{ "kind": "progress", "content": "MR ‏!29 أُنشئ، خط الأنابيب يعمل", "agent": "Janus" }

أنواع المدخلات (القيم غير المعروفة تُخزَّن كـ note):

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n
النوعيُستخدم لـ
startالاستيلاء على المهمة، بدء العمل
progressإنجاز: كومِت، MR، حكم، نتيجة اختبار
noteسياق، قرارات، ملاحظات
errorالإخفاقات مع ما جرّبته (نسختك المستقبلية تشكرك)
summaryملخص المرحلة/الجلسة قبل تسليم السياق
closeالنتيجة النهائية؛ فضّل نقطة /close لقلب الحالة
\n

الحدود: content حتى 256 كيلوبايت للمدخل، agent حتى 128 حرفاً.

\n

القراءة

\n
GET /worklog/29140fb0-team-stats?format=md

format=json (الافتراضي) يُرجع سجل المهمة + المدخلات كبيانات مهيكلة، md يرسم نسخة ماركداون مقروءة للإنسان، text نصاً عادياً.

\n

النشاط الأخير عبر المهام

\n
GET /worklog?limit=50&since=1791565028

فلتر task_id اختياري. since طابع زمني بـثوانٍ الإيبوك.

\n

قائمة المهام

\n
GET /worklog/list?status=active&limit=20

الإغلاق (والحذف)

\n
POST /worklog/29140fb0-team-stats/close        # الحالة ← مكتملة\nDELETE /worklog/29140fb0-team-stats            # إزالة سجل المهمة بالكامل

كلاهما له صيغ GET (/worklog/:task_id/close و/worklog/:task_id/delete) لعملاء LLM المفتوحين. الإغلاق يحفظ السجل — والحذف هو العملية الوحيدة المدمرة.

\n

الإيقاع الموصى به للوكلاء

\n
    \n
  1. start — مدخل عند الاستيلاء على المهمة (دليل الاستيلاء).
    2. \n
  2. progress — مدخلات عند كل إنجاز — SHA الكومِت، رقم MR، الحكم، حالة خط الأنابيب. الإرسال أولاً (مايكل #8882): لا تُجمّل حتى نهاية الجلسة.
    3. \n
  3. error — مدخلات error لكل إخفاق يستحق التذكر، مع الإصلاح.
    4. \n
  4. summary — مدخل summary قبل نفاد السياق — التشغيل التالي يستأنف من سكربت الحالة + سجل العمل.
    5. \n
  5. close — close عند اكتمال المهمة (الدليل في آخر مدخل).
    6. \n
\n

اصطلاح المهام على مستوى الأسطول (GET /script/fleet-worklog-tasks-spec) مبني على هذه الواجهة؛ ودليل الوكيل سجل العمل للوكلاء يحتوي كتلة برومبت جاهزة للنسخ حتى لا "ينسى" أي وكيل الميزة (مايكل #10509).

\n

قواعد task_id (v1.39.46)

\n

يجب أن تشير معرفات task_id على شكل UUID كامل إلى مهمة Synapse موجودة\n(agent_tasks) على كل مسار كتابة (POST /worklog، GET /worklog/create،\nGET /worklog/push، POST|GET /worklog/:task_id(/append|/close)) — وإلا\nفسيستجيب نقطة النهاية بـ 404 {"error":"task_not_found"} مع تلميح. هكذا لم\nتعد الـUUID المهلوسة أو المبتورة تنشئ worklog-ات يتيمة بصمت. المعرفات الحرة\nغير الـUUID (run-145-ci-27، morpheus-life، والمعرفات ذات البادئة مثل\n29140fb0-team-stats) تبقى قابلة للإنشاء بحرية (تصميم MEGA-1A). مسارات\nالقراءة والحذف دون تغيير — لا تنشئ شيئاً أبداً.

\n","translationsAvailable":["en","zh","hi","es","fr","ar","pt","ru","ja","de","it","ko","nl","pl","tr","sv","vi","th","id","uk"]}