fix: make profile exports portable

Author: bitfalt

commands/export.md

@@ -58,9 +58,9 @@ Start a session to create your profile, then export it.
 → Use /code-sensei:progress to initialize your profile
 ```
 
-6. If the script reports that jq is missing and a raw copy was made, add a warning:
+6. If the script reports that jq is missing, add a warning:
 
 ```
-⚠️  jq not found — raw profile copied without metadata wrapper.
-    Install jq for full export functionality: brew install jq
+⚠️  jq not found — export created without jq validation/pretty formatting.
+    The file is still importable. Install jq for full export functionality: brew install jq
 ```

commands/import.md

@@ -37,17 +37,16 @@ If the file does not exist or cannot be read, show:
 Check the path and try again.
 ```
 
-Verify the file is valid JSON with the required structure:
-- Must have a `schema_version` field
-- Must have a `profile` field containing the profile data
-- The `profile` must have at least a `belt` field
+Verify the file is valid JSON in one of these formats:
+- Preferred export format: must have a `schema_version` field and a `profile` field containing the profile data
+- Legacy/raw export format: may be the raw profile JSON itself, as long as it has at least a `belt` field
 
 If validation fails, show:
 ```
 ❌ Import failed: Invalid export file
 
 The file at [path] does not appear to be a valid CodeSensei export.
-Expected fields: schema_version, profile
+Expected either a wrapped export (`schema_version` + `profile`) or a raw profile JSON with `belt`.
 
 To create a valid export, run: /code-sensei:export
 ```
@@ -61,7 +60,7 @@ Show the user what will be imported and ask for confirmation:
 ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
 
 Import file: [path]
-Exported at: [exported_at from metadata, or "unknown"]
+Exported at: [exported_at from metadata, or "unknown" for legacy/raw exports]
 
 Profile to import:
   [Belt Emoji] Belt:             [belt]
@@ -92,16 +91,26 @@ Wait for the user's response.
      cp ~/.code-sensei/profile.json ~/.code-sensei/profile.json.backup 2>/dev/null && echo "backed_up" || echo "no_existing_profile"
      ```
 
-2. Extract and write the profile data:
-   - The profile data is in the `profile` field of the import file
-   - Write the contents of `import_data.profile` to `~/.code-sensei/profile.json`
+2. Create the target directory if needed:
+   - Use the Bash tool to run:
+     ```bash
+     mkdir -p ~/.code-sensei
+     ```
+
+3. Extract and write the profile data:
+   - If the import file has a `profile` field, write `import_data.profile` to `~/.code-sensei/profile.json`
+   - If it is a legacy/raw export, write the full file contents as-is to `~/.code-sensei/profile.json`
    - Use `jq` if available for clean extraction:
      ```bash
-     jq '.profile' [import file path] > ~/.code-sensei/profile.json
+     if jq -e '.profile' [import file path] > /dev/null 2>&1; then
+       jq '.profile' [import file path] > ~/.code-sensei/profile.json
+     else
+       cp [import file path] ~/.code-sensei/profile.json
+     fi
      ```
-   - If jq is not available, instruct the user to manually copy the `profile` object from the import file
+   - If jq is not available, instruct the user to manually copy the `profile` object from the import file, or the full file for legacy/raw exports
 
-3. Show the success message:
+4. Show the success message:
 
 ```
 🥋 CodeSensei — Import Complete
@@ -132,6 +141,6 @@ Use /code-sensei:progress to view your full dashboard.
 ## Important Notes
 
 - Always back up before overwriting — never skip the backup step
-- The import file's `profile` field is the raw profile data — do not import the metadata wrapper itself
+- The preferred import path reads the `profile` field from wrapped exports; legacy/raw exports can be copied directly
 - If jq is unavailable, warn the user and provide manual instructions
 - After a successful import, do NOT reset session_concepts — preserve it as-is from the imported profile

scripts/export-profile.sh

@@ -4,9 +4,9 @@
 
 PROFILE_DIR="$HOME/.code-sensei"
 PROFILE_FILE="$PROFILE_DIR/profile.json"
-EXPORT_DATE=$(date -u +%Y-%m-%d)
+EXPORT_STAMP=$(date -u +%Y-%m-%dT%H-%M-%SZ)
 EXPORT_TIMESTAMP=$(date -u +%Y-%m-%dT%H:%M:%SZ)
-EXPORT_FILE="$HOME/code-sensei-export-${EXPORT_DATE}.json"
+EXPORT_FILE="$HOME/code-sensei-export-${EXPORT_STAMP}-$$.json"
 
 # Resolve plugin version from plugin.json if CLAUDE_PLUGIN_ROOT is set
 PLUGIN_VERSION="unknown"
@@ -44,11 +44,19 @@ if command -v jq &> /dev/null; then
 
   echo "$EXPORT_FILE"
 else
-  # jq not available — raw copy with a warning to stderr
-  echo "WARNING: jq not found. Copying raw profile without metadata wrapper." >&2
+  # jq not available — still create an importable wrapper without validation/pretty-printing
+  echo "WARNING: jq not found. Creating export without jq validation/pretty formatting." >&2
   echo "Install jq for full export functionality: brew install jq" >&2
 
-  cp "$PROFILE_FILE" "$EXPORT_FILE"
+  {
+    printf '{\n'
+    printf '  "schema_version": "1.0",\n'
+    printf '  "exported_at": "%s",\n' "$EXPORT_TIMESTAMP"
+    printf '  "plugin_version": "%s",\n' "$PLUGIN_VERSION"
+    printf '  "profile": '
+    cat "$PROFILE_FILE"
+    printf '\n}\n'
+  } > "$EXPORT_FILE"
 
   if [ $? -ne 0 ]; then
     echo "ERROR: Failed to copy profile to $EXPORT_FILE" >&2