Project Export Command

Export the entire Bookstrap project for backup, sharing, or archiving.

What It Does

Creates a complete project export including:

• Manuscript files
• Database backup
• Configuration files
• Source documents
• Research notes
• Edit reports
• Git history (optional)

Usage

/bookstrap-export-project --output project-export.zip

Options

/bookstrap-export-project \
  --output export.zip \
  --include-git \
  --include-sources \
  --format zip

Export Contents

Always Included

• manuscript/ - All written sections
• BRD.md - Book Requirements Document
• bookstrap.config.json - Project configuration
• database-backup.surql - Full database export
• export-manifest.json - Metadata about the export

Optional Inclusions

• --include-git: Include .git directory (version history)
• --include-sources: Include ingested source documents
• --include-logs: Include edit reports and logs
• --include-schema: Include database schema files

Export Formats

ZIP Archive (default)

/bookstrap-export-project --output my-book.zip

Creates a compressed ZIP file.

TAR.GZ Archive

/bookstrap-export-project --output my-book.tar.gz --format tar.gz

Creates a compressed tarball.

Directory

/bookstrap-export-project --output my-book-export --format directory

Exports to a directory (no compression).

Export Manifest

Each export includes export-manifest.json:

{
  "project_name": "My Book",
  "exported_at": "2026-02-01T12:00:00Z",
  "bookstrap_version": "1.0.0",
  "export_format": "zip",
  "contents": {
    "manuscript": {
      "chapters": 12,
      "sections": 48,
      "total_words": 75420,
      "status": "draft"
    },
    "database": {
      "sources": 42,
      "entities": 156,
      "relationships": 384
    },
    "configuration": {
      "embedding_provider": "openai",
      "search_provider": "tavily"
    }
  },
  "checksums": {
    "manuscript": "sha256:abc123...",
    "database": "sha256:def456..."
  }
}

Implementation

#!/bin/bash

OUTPUT=$1
FORMAT=${2:-zip}

# Create temporary export directory
EXPORT_DIR=$(mktemp -d)
PROJECT_NAME=$(basename $(pwd))

echo "Exporting project to: $OUTPUT"

# Export manuscript
cp -r manuscript/ $EXPORT_DIR/manuscript/

# Export configuration
cp BRD.md $EXPORT_DIR/
cp bookstrap.config.json $EXPORT_DIR/

# Backup database
./scripts/backup-db.sh $EXPORT_DIR/database-backup.surql

# Generate manifest
python ./scripts/generate-export-manifest.py \
  --output $EXPORT_DIR/export-manifest.json

# Optional: Include git history
if [[ "$INCLUDE_GIT" == "true" ]]; then
  cp -r .git $EXPORT_DIR/
fi

# Create archive
if [[ "$FORMAT" == "zip" ]]; then
  cd $EXPORT_DIR && zip -r $OUTPUT *
elif [[ "$FORMAT" == "tar.gz" ]]; then
  tar -czf $OUTPUT -C $EXPORT_DIR .
else
  mv $EXPORT_DIR $OUTPUT
fi

echo "Export complete: $OUTPUT"

Import/Restore

To restore from an export:

/bookstrap-import-project --input project-export.zip

This will:

1. Extract archive
2. Restore database from backup
3. Copy manuscript files
4. Restore configuration
5. Verify integrity using checksums

Best Practices

1. Export regularly for backup
2. Include git history for version control
3. Exclude sources if large files (can re-ingest)
4. Verify export before deleting originals
5. Use semantic versioning for export filenames

Use Cases

Backup

/bookstrap-export-project \
  --output backups/my-book-$(date +%Y%m%d).zip \
  --include-git

Sharing with Collaborators

/bookstrap-export-project \
  --output my-book-collab.zip \
  --include-sources \
  --include-logs

Archiving Final Version

/bookstrap-export-project \
  --output my-book-final-v1.0.zip \
  --include-git \
  --include-sources \
  --include-logs

Example Output

Exporting Bookstrap project...

Preparing export directory...
├─ Copying manuscript (48 sections, 75,420 words)
├─ Copying configuration files
├─ Backing up database (42 sources, 156 entities)
├─ Generating export manifest
├─ Calculating checksums
└─ Creating ZIP archive

Export complete!

File: my-book-export.zip
Size: 12.4 MB
Contents:
  - Manuscript: 48 sections
  - Database: 42 sources, 156 entities
  - Configuration: bookstrap.config.json
  - Git history: 127 commits

Verify with: unzip -l my-book-export.zip