migrate-workspace

يُرحِّل مساحة عمل قديمة لكل مساعد برمجي إلى التخطيط المشترك .apothem.

الموجز

apothem migrate-workspace [--project PATH] [--dry-run]
                          [--quiet|-q] [--verbose|-v]
                          [--format plain|json] [--json] [--no-color]

يطوي migrate-workspace دليل بيانات قديمًا لكل مساعد برمجي (.apothem/<harness>/...) وشجرة .plans/ قديمة في دليل العمل المشترك الواحد .apothem/{plans,memory,learning,contexts}. القاعدة هي جذر --project المُحَلّ عند تقديمه، وإلا فدليل العمل الحالي (الافتراضي المحلي للمشروع).

تندمج الذاكرة والسياقات ومخازن التعلّم لكل مساعد برمجي اندماجًا اتحاديًّا في المخزن المشترك حسب المُعرِّف؛ وتُسلسَل إشارات التعلّم مع إزالة التكرار؛ ويُتخطّى سجلٌّ متعارض (المُعرِّف نفسه، جسم مختلف)، ولا يُكتَب فوقه أبدًا. تُنقَل شجرة .plans/ قديمة تحت .apothem/plans/. ويُنسَخ كل مصدر مُستهلَك احتياطيًّا أولًا. الترحيل عديم الأثر — إعادة تشغيله على شجرة مُرحَّلة سلفًا لا تفعل شيئًا.

الخيارات

الخيار	الوصف
`--project PATH`	جذر المشروع للمُحَوِّلات بنطاق المشروع التي تتجسّد في شجرة مشروع بدلًا من دليل تهيئة بنطاق المستخدم.
`--dry-run`	يكتشف التخطيط القديم ويُبلِّغ بما سيُرحَّل دون كتابة.
`--quiet`, `-q`	يُخمِد المخرجات المعلوماتية؛ تُصدَر الأخطاء فقط.
`--verbose`, `-v`	يُصدِر مخرجات تشخيصية إضافية.
`--format plain\|json`	تنسيق المخرجات (الافتراضي: `plain`).
`--json`	اختصار لـ `--format json`.
`--no-color`	يُعطِّل رموز ألوان ANSI في المخرجات.
`-h`, `--help`	يعرض المساعدة ويخرج.

مخرجات JSON

يحمل غلاف --json نتيجة الترحيل. عند اكتمال الترحيل تكون status هي success، وتُبلِّغ الحمولة بأعداد السجلّات المُدمَجة، وما إذا نُقِلت شجرة .plans/، وجذر النسخ الاحتياطي، وأي تعارضات مُتخطّاة. يُبلِّغ استدعاء --dry-run بدلًا من ذلك بـ legacy_layout_detected.

{
  "command": "migrate-workspace",
  "status": "success",
  "base": "/home/example/project",
  "migrated": true,
  "backup_root": "/home/example/project/.apothem/.backups/01J9Z…",
  "memory_merged": 12,
  "contexts_merged": 4,
  "learning_merged": 7,
  "conflicts": [],
  "plans_moved": true,
  "notes": []
}

عند عدم وجود تخطيط قديم، تكون migrated هي false ولا يُكتَب أي شيء. يُسقِط غلاف --dry-run أعداد النتيجة ويُبلِّغ بالاكتشاف فقط:

{
  "command": "migrate-workspace",
  "base": "/home/example/project",
  "dry_run": true,
  "legacy_layout_detected": false
}

أمثلة

apothem migrate-workspace
apothem migrate-workspace --project .
apothem migrate-workspace --dry-run --json

رموز الخروج

الرمز	المعنى
0	اكتمل الترحيل، أو لم يُعثَر على تخطيط قديم (لا شيء لترحيله)
1	خطأ متوقَّع — خطأ تحقّق أو خطأ في جذر المشروع، أو فشل ترحيل

انظر أيضًا

apothem install — تجسيد مساعد برمجي من الملف الشخصي المشترك
apothem status — الإبلاغ بحالة التثبيت والتحقّق والانحراف
انضباط الخطط — التخطيط المشترك .apothem/plans/