migrate-workspace

ترحيل مساحة عمل قديمة خاصة بكل إطار عمل إلى البنية المشتركة .apothem.

الموجزCopy Anchor Link

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/. ويُنسَخ كل مصدر مُستهلَك احتياطيًا أولًا. والترحيل متساوي الأثر عند التكرار — إعادة تشغيله على شجرة مُرحَّلة سلفًا لا تفعل شيئًا.

الخياراتCopy Anchor Link

مخرجات JSONCopy Anchor Link

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

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

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

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

أمثلةCopy Anchor Link

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

رموز الخروجCopy Anchor Link

انظر أيضًاCopy Anchor Link

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