الصيانة

Migrate: انقل مشروع Lagune القائم على manifest إلى المهارات والإضافات

انقل مشروع Lagune القائم على manifest إلى Lagune القائم على المهارات، مع الحفاظ على ميثاق الأمان والمُخرَجات والتتبع وتخصصاتك الخاصة.

🔀 انقل مشروع Lagune القائم على manifest إلى Lagune القائم على المهارات، مع الحفاظ على كل ما كتبته.

إشعار إهمال

يستمر المشروع الذي يحتوي على manifest في العمل كما هو حتى v1.x: يسلّم npx lagune الأوامر init و pull و update و add و remove و list ولوحة التحكم إلى lagune@0.15.0، آخر إصدار قائم على manifest.

النقل​

  1. تأكد من أن عملك الحالي محفوظ في commit، ثم شغّل migrate من جذر المشروع:

    npx lagune migrate
  2. أضف إلى commit ما غيّره فقط، ليبقى النقل تغييرًا واحدًا قابلًا للمراجعة.

  3. ثبّت الأوامر لوكيلك، كما تعرض صفحة التثبيت.

  4. إن كان في المشروع مُخرَج detect أو plan أو harden بالفعل، فاطلب من /lagune-repair مواءمة المراجع القديمة فيها وفي تخصصاتك الخاصة:

    /lagune-repair وائم التخصصات المطبّقة (sub-skills سابقًا) في المُخرَجات تحت `.lagune/memory/` (`detect.md` و `plan.md` و `harden.md`) مع الأسماء التي يسردها الكتالوج الجديد، وأعد كتابة كل استدعاء تجريه تخصصاتي الخاصة في `.lagune/catalog/` إلى الـ hooks القديمة في `.lagune/hooks/` كاستدعاء للأداة `lagune_read` أو `lagune_write`.

ما الذي يتغيّر​

قبلبعد
.lagune/templates/ و .lagune/hooks/ و .lagune/specializations.mdأُزيلت: تحمل كل مهارة قالبها، ويشغّل المحرك الـ hooks
نسخ التخصصات المدمجة في .lagune/skills/أُزيلت: يقدّم المحرك التخصصات المدمجة
تخصصاتك الخاصة في .lagune/skills/نُقلت إلى .lagune/catalog/
.lagune/skills.json، فهرس تخصصاتك الخاصةدُمج في .lagune/configs.json
فئات الـ manifestسُجّلت في .lagune/configs.json
أوامر الوكيل القديمة، مثل /lagune.detectأُزيلت: تثبيت Lagune يجلب الأوامر الجديدة، مثل /lagune-detect
كتلة Lagune في .gitignoreأُزيلت، مع الملف إن لم يكن يحتوي على شيء آخر
.lagune/proofs/، الذي كانت تتجاهله تلك الكتلةيُبقيه ملف .gitignore الخاص به خارج كل commit
.lagune/manifest.jsonحُذف، في النهاية

يبقى عملك الأمني كما هو: ميثاق الأمان، والمُخرَج الذي أنتجته كل مرحلة، وخريطة التتبع بالمسارات التي تشير إليها كل ملاحظة.

الأسئلة الشائعة

نعم. المشاريع القائمة على manifest مُهملة ولن تستمر في العمل إلا حتى v1.x، لذلك شغّل npx lagune migrate لنقل مشروعك.

ميثاق الأمان، وكل مُخرَجات المراحل، وخريطة التتبع، وفئاتك، وتخصصاتك الخاصة. تنتقل التخصصات إلى ‎.lagune/catalog/‎، وينضم فهرسها إلى فئاتك في ‎.lagune/configs.json.

بعد migrate، كما تعرض صفحة التثبيت لوكيلك. والتثبيت أولًا يعمل أيضًا، لأن migrate يحافظ على الأمر الجديد ‎/lagune.

اسحب النقل، ثم شغّل npx lagune migrate مرة واحدة. يزيل ما تركه Lagune القائم على manifest في نسختك المحلية، وهو ما لم يحمله نظام التحكم في الإصدارات أبدًا، ويُبقي إثباتاتك خارج كل commit.