Skip to content
Apothem
CLI संदर्भ

migrate-workspace

apothem migrate-workspace कमांड के लिए CLI संदर्भ।

किसी विरासत प्रति-हार्नेस वर्कस्पेस को साझा .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 रूट होता है, अन्यथा वर्तमान वर्किंग डायरेक्टरी (प्रोजेक्ट-स्थानीय डिफ़ॉल्ट)।

प्रति-हार्नेस मेमोरी, कॉन्टेक्स्ट और लर्निंग स्टोर id के आधार पर साझा स्टोर में यूनियन-मर्ज होते हैं; लर्निंग सिग्नल जोड़े जाते हैं और उनके दोहराव हटा दिए जाते हैं; विरोधी रिकॉर्ड (समान id, भिन्न बॉडी) छोड़ दिया जाता है, कभी अधिलेखित नहीं किया जाता। विरासत .plans/ वृक्ष .apothem/plans/ के अंतर्गत चला जाता है। हर उपभोग किए गए स्रोत का पहले बैकअप लिया जाता है। माइग्रेशन इडेम्पोटेंट है — पहले से माइग्रेट किए गए वृक्ष पर इसे फिर से चलाना कोई प्रभाव नहीं डालता (no-op)।

विकल्प

विकल्पविवरण
--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 रिपोर्ट करता है।

{
  "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
}

उदाहरण

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

निकास कोड

कोडअर्थ
0माइग्रेशन पूर्ण हुआ, या कोई विरासत लेआउट नहीं मिला (माइग्रेट करने के लिए कुछ नहीं)
1अपेक्षित त्रुटि — कोई सत्यापन या प्रोजेक्ट-रूट त्रुटि, या माइग्रेशन विफलता
64उपयोग त्रुटि: कोई अज्ञात विकल्प या कमांड, या कोई लुप्त या अमान्य विकल्प मान। --json के अंतर्गत त्रुटि cli.usage कोड वाला एक JSON एनवेलप होती है।

यह भी देखें

  • apothem install — साझा प्रोफ़ाइल से किसी हार्नेस को मटेरियलाइज़ करें
  • apothem status — इंस्टॉल, सत्यापन और ड्रिफ़्ट स्थिति की रिपोर्ट करें
  • प्लान अनुशासन — साझा .apothem/plans/ लेआउट

On this page