XI.ספר ההתקנה · v0.13

אימות הארכיון / תצוגה מקדימה לכל כתיבה / שמירת דרך חזרה

מתקינים STOLZ A.I. בלי קפיצה אל הלא נודע.

השתמשו בחבילת v0.13 הבלתי משתנה בתוך הפרויקט הצורך והתחילו כל שינוי במחזור החיים בפקודת בדיקה.

02

2. התקנה בפרויקט הצורך

התקינו את הארכיון שהורד כתלות פיתוח. לאחר מכן ה־CLI אינו מושך חבילה אחרת.

terminal / npm
npm install --save-dev /absolute/downloads/stolz-ai-0.13.0.tgz
03

3. בחירה, תצוגה מקדימה והתקנת הפרופיל

בחרו את פרופיל Codex, סקרו את תוכנית ההתקנה הדטרמיניסטית והוסיפו `--apply` רק אחרי בדיקת היעד והקבצים המנוהלים.

terminal / profile
npx --no-install stolz-profile resolve --runtime codex
npx --no-install stolz-profile install --runtime codex --destination /absolute/path/to/skills --dry-run
npx --no-install stolz-profile install --apply --runtime codex --destination /absolute/path/to/skills
04

4. הרצת doctor

Doctor אינו קורא לספק או למודל. הוא מדווח על מצב ההתקנה, גרסת סביבת הריצה שנצפתה, בסיס התאימות, זמינות המתאם העצל והפעולה הבאה.

terminal / doctor
npx --no-install stolz-profile doctor --runtime codex --runtime-version <version> --destination /absolute/path/to/skills
05

5. שמירת נעילת צוות ואימותה ב־CI

קובץ הנעילה מכיל זהות חבילה ופרופיל, לא פרטי גישה או נתיבים מקומיים. `verify-lock` מכשיל CI בסטייה, בנעילה לא תקינה או בגרסת סביבת ריצה מדווחת שאינה תואמת.

terminal / team lock
npx --no-install stolz-profile lock --apply --runtime codex --lockfile ./stolz-profile.lock.json
npx --no-install stolz-profile verify-lock --runtime codex --lockfile ./stolz-profile.lock.json
06

6. סקירת עדכון לפני החלתו

הפקודה הראשונה מציגה את השינוי העתידי. החילו רק לאחר סקירה; קובץ STOLZ חסר או ששונה מקומית עוצר את העדכון.

terminal / update
npx --no-install stolz-profile update --runtime codex --destination /absolute/path/to/skills
npx --no-install stolz-profile update --apply --runtime codex --destination /absolute/path/to/skills
07

7. שחזור עדכון שנקטע

אם doctor מדווח `recovery_required`, סקרו תחילה את השחזור. הוספת `--apply` משחזרת את ההתקנה הקודמת שאומתה ביומן העסקה.

terminal / recover
npx --no-install stolz-profile recover --dry-run --destination /absolute/path/to/skills
npx --no-install stolz-profile recover --apply --destination /absolute/path/to/skills
08

8. חזרה לאחור באותה משמעת

סקרו את החזרה לפני החלתה. החזרה מסרבת לדרוס קובץ מנוהל ששונה מקומית.

terminal / rollback
npx --no-install stolz-profile rollback --dry-run --destination /absolute/path/to/skills
npx --no-install stolz-profile rollback --apply --destination /absolute/path/to/skills

§ 3scope / evidence

מה הבדיקות מוכיחות

הן מוכיחות את זהות החבילה, התצורה שנבחרה והקבצים שבמניפסט. הן אינן מוכיחות תאימות מודל, טוקנים של ספק, חיוב, עלות או חיסכון.

09

המשך בפרויקט אמיתי

עדיין אין בעלים לפיילוט אמיתי. השתמשו ביומן הפיילוט הכלול רק לאחר שבעל הפרויקט מסכים להשתתף.

חזרה לגרסה v0.13