fix(files): "נוצר" שייך לקובץ, לא לגרסה — הורשת created_at בעריכה

CLAUDE.md

@@ -51,6 +51,8 @@ codekeeper_search_repo(repo="amir-bug-patterns", query="<מונח>")
 | PyGithub / קריאות SDK חיצוני | `BY-STACK/external-sdk.md` |
 | קבצי `docs/**/*.rst` | `bugbot-rules/line-number-coupling.md` |
 | טסטים עם סטאבים ידניים | `TESTING-PATTERNS.md` + `bugbot-rules/widened-exception-scope.md` |
+| שינוי חתימה או חוזה של פונקציה שיש לה דאבל בטסטים (fake/stub/mock) | `TESTING-PATTERNS.md` T4 + `bugbot-rules/double-mirrors-signature-not-contract.md` |
+| תכונה שמסתמכת על `hidden`, או כלל CSS שנטען גלובלית ועלול לדלוף לעמוד אחר | `TESTING-PATTERNS.md` T1(c) — בדיקת שרת רואה את התכונה, לא את ההתנהגות |
 | הרכבת URL/מחרוזת שמכילה סוד, הודעות חריגה, ניקוי לוגים/Sentry | `CRITICAL-PATTERNS.md` K13 + `bugbot-rules/secret-in-derived-text.md` |
 | מפתח/טוקן שמועבר כפרמטר URL (`params={"key": ...}`), או שינוי ברשימת דפוסי הניקוי | `CRITICAL-PATTERNS.md` K14 + `bugbot-rules/secret-in-url-query.md` |
 | מסיר שורת לוג, או עוטף אותה ב-guard שמונע הערכת ארגומנטים (הטריגר הנפוץ: תיקון PII) | `bugbot-rules/side-effect-riding-on-log-line.md` |
@@ -61,6 +63,7 @@ codekeeper_search_repo(repo="amir-bug-patterns", query="<מונח>")
 הדפוס הזה כבר עלה בריפו הזה **שלוש פעמים** (`save_backup_bytes` ב-PR #3232 ב-#3172, ו-`delete_pattern` של הקאש).
 - **לפני כתיבת טסט חדש** → `claude-md-snippets/testing.md`. בפרט: טסט שנוסח עם תיקון חייב להיכשל בלי התיקון — הרץ אותו על הקוד הישן וּודא שהוא נופל.
 - **אחרי שטסט נופל על חריגה** → `bugbot-rules/widened-exception-scope.md`. אל תרחיב `except` כדי לעבור; בדוק קודם את הסטאב/fixture — שם השורש בדרך כלל.
+- **אחרי ששינית חוזה של פונקציה** → עדכן את הדאבלים שלה כך ש**יאכפו** את החוזה החדש, לא רק יקבלו את החתימה. דאבל שממשיך להחזיר הצלחה ללא תנאי הוא בדיקה שאינה מסוגלת להיכשל. ובחר את חבילות הטסטים להרצה לפי **מי קורא לפונקציה**, לא לפי דפוס שם קובץ. עלה כאן ב-PR #3305: `edit_file` ו-`append_file` נשברו לגמרי וכל הטסטים נשארו ירוקים.
 
 ### סגירת הלולאה (חובה, לא רשות)
 

database/repository.py

@@ -211,6 +211,16 @@ def save_code_snippet(self, snippet: CodeSnippet) -> bool:
             existing = self._fetch_latest_version(snippet.user_id, snippet.file_name)
             if existing:
                 snippet.version = existing['version'] + 1
+                # ``created_at`` שייך לקובץ הלוגי, לא לגרסה. בלי ההורשה כאן,
+                # כל עריכת תוכן הייתה מזיזה את "נוצר" בממשק לתאריך העריכה —
+                # בעוד שעריכת תיאור (עדכון-במקום) משמרת אותו. תאריך הגרסה
+                # עצמה ממשיך לחיות ב-``updated_at`` שלה, וההיסטוריה מציגה
+                # אותו. ``or`` ולא השמה עיוורת: מסמך ותיק בלי השדה לא אמור
+                # לאפס את ברירת המחדל שהמודל כבר קבע.
+                try:
+                    snippet.created_at = existing.get('created_at') or snippet.created_at
+                except Exception:
+                    pass
                 # שמור סטטוס מועדפים מהגרסה הקודמת אם לא סופק מפורשות
                 try:
                     prev_is_fav = bool(existing.get('is_favorite', False))

docs/mcp-server.rst

@@ -56,9 +56,12 @@ OAuth 2.1) וגם מול **Claude Code / Claude Desktop** (טוקן אישי).
    * - ``codekeeper_get_file``
      - תוכן מלא של קובץ (לפי שם/מזהה, אופציונלית גרסה)
    * - ``codekeeper_save_file``
-     - **כתיבה:** יצירה/עדכון קובץ (גרסה חדשה; בכפוף למגבלת
-       ``MAX_CODE_SIZE`` — ברירת מחדל 100K תווים, ניתנת להגדלה בקונפיג).
-       דורש ``write``
+     - **כתיבה:** יצירת קובץ חדש. שם קיים נדחה עם ``error=file_exists`` —
+       עדכון דורש ``update_existing=true`` מפורש (נשמר כגרסה חדשה;
+       הישנות נשארות בהיסטוריה, אך החיפוש והתצוגה מציגים רק את
+       האחרונה). לשינוי חלקי — ``edit_file``/``append_file``. בכפוף
+       למגבלת ``MAX_CODE_SIZE`` (ברירת מחדל 100K תווים, ניתנת להגדלה
+       בקונפיג). דורש ``write``
    * - ``codekeeper_edit_file``
      - **כתיבה:** מצא-והחלף מדויק בקובץ קיים (``old_string`` →
        ``new_string``) — בלי לשלוח את כל הקובץ. נשמר כגרסה חדשה. דורש

mcp_server/README.md

@@ -29,7 +29,7 @@ Claude Desktop** (טוקן אישי). קריאה זמינה תמיד; **כתיב
 | `codekeeper_list_files` | רשימת קבצים (מטא‑דאטה בלבד), עם עימוד |
 | `codekeeper_search_code` | חיפוש טקסט בקוד → מטא‑דאטה של קבצים תואמים |
 | `codekeeper_get_file` | תוכן מלא של קובץ לפי `file_name` או `file_id` (אופציונלי: גרסה) |
-| `codekeeper_save_file` | **כתיבה:** יצירה/עדכון קובץ לפי `file_name` (גרסה חדשה, לא דורס; בכפוף ל‑`MAX_CODE_SIZE`, ברירת מחדל 100K תווים וניתן להגדלה). דורש `write` |
+| `codekeeper_save_file` | **כתיבה:** יצירת קובץ חדש לפי `file_name`. שם קיים נדחה עם `error=file_exists` — עדכון דורש `update_existing=true` מפורש (נשמר כגרסה חדשה; הישנות בהיסטוריה, אך החיפוש והתצוגה מציגים רק את האחרונה). לשינוי חלקי עדיף `edit_file`/`append_file`. בכפוף ל‑`MAX_CODE_SIZE` (ברירת מחדל 100K תווים, ניתן להגדלה). דורש `write` |
 | `codekeeper_edit_file` | **כתיבה:** מצא‑והחלף מדויק (`old_string`→`new_string`, אופציונלית `replace_all`) בלי לשלוח את כל הקובץ; גרסה חדשה, משמר שפה/תיאור/תגיות. דורש `write` |
 | `codekeeper_append_file` | **כתיבה:** הוספת טקסט לסוף קובץ קיים (מוסיף שורת‑הפרדה אם צריך); גרסה חדשה. דורש `write` |
 | `codekeeper_list_versions` | היסטוריית גרסאות של קובץ (מטא‑דאטה) |

mcp_server/backend.py

@@ -355,6 +355,7 @@ def save_file(
         programming_language: str,
         description: str = "",
         tags: list[str] | None = None,
+        update_existing: bool = False,
     ) -> dict[str, Any]:
         """Create a new file or append a new version of an existing one.
 
@@ -369,6 +370,26 @@ def save_file(
         dbm = self._require_dbm()
         # Captured before the save so we can report create vs. update honestly.
         prev = _latest_fresh(dbm, user_id, file_name)
+        # Updating an existing name must be an explicit choice. The silent
+        # upsert bit for real: saving new content under a name that already
+        # holds something else hides the old content from search and from the
+        # normal view (both read the latest version only), leaving it
+        # reachable only through the version history. Full-content rewrites
+        # stay possible via update_existing=True; partial changes belong to
+        # edit_file/append_file.
+        if prev is not None and not update_existing:
+            return {
+                "ok": False,
+                "error": "file_exists",
+                "file_name": file_name,
+                "latest_version": int(prev.get("version") or 0),
+                "hint": (
+                    "A file with this name already exists. To change part of it "
+                    "use codekeeper_edit_file or codekeeper_append_file; to "
+                    "replace its content entirely, pass update_existing=true; "
+                    "or pick a different file_name."
+                ),
+            }
         ok = bool(
             dbm.save_code_snippet(
                 CodeSnippet(

mcp_server/handlers.py

@@ -123,6 +123,7 @@ def save_file(
     code: str,
     language: str | None = None,
     description: str = "",
+    update_existing: bool = False,
 ) -> dict[str, Any]:
     """Validate + normalize a save request, then delegate to the backend.
 
@@ -157,6 +158,7 @@ def save_file(
         code=code,
         programming_language=lang,
         description=(description or "").strip(),
+        update_existing=bool(update_existing),
     )
 
 
@@ -209,6 +211,11 @@ def _resave_edited(
         programming_language=str(doc.get("programming_language") or doc.get("language") or "text"),
         description=str(doc.get("description") or ""),
         tags=list(doc.get("tags") or []),
+        # ``edit_file``/``append_file`` פועלים **בהגדרה** על קובץ קיים — הם
+        # מגיעים לכאן רק אחרי ``get_file`` מוצלח. לכן ``prev`` תמיד מלא,
+        # ובלי הדגל הזה שער ה-``file_exists`` היה חוסם את שני הכלים לגמרי.
+        # השער נועד למנוע דריסה בשוגג ב-``save_file``, לא לחסום עריכה.
+        update_existing=True,
     )
 
 

mcp_server/server.py

@@ -33,7 +33,7 @@
     "Access the current user's private code files and collections stored in "
     "CodeKeeper. Use codekeeper_search_code / codekeeper_list_files to find files "
     "(metadata only), and codekeeper_get_file to read full contents. Use "
-    "codekeeper_save_file to create or update a file, and prefer "
+    "codekeeper_save_file to create a file (updating an existing name requires update_existing=true), and prefer "
     "codekeeper_edit_file / codekeeper_append_file to change part of an existing "
     "file without resending all of it (write tools require write permission). "
     "Sticky notes live on a file, on a board (a surface that belongs to no file), or "
@@ -232,8 +232,13 @@ def get_file(
     @mcp.tool(
         name="codekeeper_save_file",
         description=(
-            "Create a new file or update an existing one by file_name (saved as a new, "
-            "non-destructive version — old versions are kept). Requires write permission."
+            "Create a NEW file by file_name. If the name already exists the call "
+            "is refused with error=file_exists — updating an existing file must "
+            "be explicit: pass update_existing=true to replace its content as a "
+            "new non-destructive version (old versions are kept in history, but "
+            "search and the normal view show only the latest), or use "
+            "codekeeper_edit_file / codekeeper_append_file for partial changes. "
+            "Requires write permission."
         ),
         annotations=_WRITE_TOOL,
     )
@@ -243,6 +248,7 @@ def save_file(
         code: str,
         language: str | None = None,
         description: str = "",
+        update_existing: bool = False,
     ) -> dict:
         require_write(ctx)  # reject a read-only token before touching anything
         return handlers.save_file(
@@ -252,6 +258,7 @@ def save_file(
             code=code,
             language=language,
             description=description,
+            update_existing=update_existing,
         )
 
     @mcp.tool(