# Release readiness notes

## Triage summary

This repository is a lightweight shell-script distribution for SendPreview-2-Notion. There is no build system or package metadata yet; release prep is primarily script validation, documentation, installer ergonomics, and manual Notion smoke testing.

## Current release blockers

1. **End-to-end Notion smoke test not run in this cleanup pass**
   - Requires a real Notion integration token, target database, and sample image.
   - Test should verify: file upload object creation, binary upload, page creation, and image block append.

2. **Confirm Notion API version/data source behavior before tagging**
   - The script currently defaults to `NOTION_VERSION=2025-09-03` and creates pages with `parent.database_id`.
   - The README previously mentioned `NOTES_DATA_SOURCE_ID`, but the script did not use it. Before release, validate whether this project should target database IDs or the newer data source APIs and update the script/docs together.

3. **Packaging/distribution is intentionally source-first for now**
   - `scripts/install.sh` is suitable for source installs and remains the release path used in this cleanup pass.
   - No signed `.pkg`, Homebrew formula, notarized app, or Shortcuts import bundle exists yet.
   - Packaging should stay out of scope until the offline harness and README install steps are stable.

## Suggested release checklist

- Run `bash -n scripts/*.sh tests/*.sh`.
- Run `tests/dry_run.sh` to exercise offline script and installer behavior without Notion credentials or GUI automation.
- Run `shellcheck scripts/*.sh tests/*.sh` if ShellCheck is available.
- Install with `./scripts/install.sh` on a clean macOS user account.
- Configure a disposable/test Notion database with matching `Name` and `Type` properties.
- Run `~/.local/bin/send_to_notion_image.sh /path/to/sample.jpg`.
- Confirm the resulting Notion page title, `Type=Image`, and appended image block.
- Decide release distribution format:
  - Source zip/tarball with installer script
  - Homebrew tap formula
  - Signed macOS package
  - Shortcut export plus script installer

## Manual test environment needed

- macOS with GUI session access for `osascript` dialog prompts.
- Homebrew + `jq`.
- Notion internal integration token.
- Target Notion database shared with the integration.