Presentation Bundle Manager

Presentation Bundle Manager

Collect all deliverables from /deliverables/<slug>/, generate index.xlsx and manifest.json, and confirm the bundle is complete.

Required Inputs

Bundle Workflow

1. Scan the deliverables folder: list all files in /deliverables/<slug>/.
2. Validate expected files: check that the five core files are present:
   • storyboard.docx
   • storyboard.json
   • deck.pptx
   • speaker-notes.docx
   • (index.xlsx and manifest.json will be created in this step)
3. Report missing files: list any core files that are absent and offer to generate them via their respective sub-skills.
4. Run the bundle script:

python3 suites/presentation/presentation-bundle-manager/scripts/bundle_manager.py \
  --slug <slug> \
  --path /deliverables/<slug> \
  --title "<project_title>" \
  --author "<author>"

5. Confirm output: verify index.xlsx and manifest.json exist in the folder.

index.xlsx Structure

The Excel index has two sheets:

Sheet 1 — Summary

Sheet 2 — Files

manifest.json Schema

{
  "schema_version": "1.0",
  "project": {
    "title": "<project_title>",
    "slug": "<slug>",
    "author": "<author>",
    "generated_at": "<ISO 8601 timestamp>",
    "generated_by": "presentation-bundle-manager"
  },
  "deliverables": [
    {
      "file": "storyboard.docx",
      "type": "storyboard",
      "size_bytes": 0,
      "sha256": "<hash>",
      "status": "present"
    },
    {
      "file": "storyboard.json",
      "type": "storyboard_json",
      "size_bytes": 0,
      "sha256": "<hash>",
      "status": "present"
    },
    {
      "file": "deck.pptx",
      "type": "presentation",
      "size_bytes": 0,
      "sha256": "<hash>",
      "status": "present"
    },
    {
      "file": "speaker-notes.docx",
      "type": "speaker_notes",
      "size_bytes": 0,
      "sha256": "<hash>",
      "status": "present"
    }
  ],
  "validation": {
    "all_core_files_present": true,
    "warnings": []
  }
}

Validation Rules

• If any core file is missing, set "status": "missing" in the manifest and "all_core_files_present": false.
• Add a warning entry for each missing file.
• Do not block bundle creation for missing files — produce the index with whatever is present.

Output

Saves two files to /deliverables/<slug>/:

• index.xlsx — requires openpyxl (pip install openpyxl)
• manifest.json — pure Python standard library, no dependencies

Limitations

• Does not zip or compress the bundle — the user can do this manually if needed.
• SHA256 hashes require file access; if files were not saved locally, the hash field is omitted.
• Does not upload or publish the bundle to any external service.