Add sqlite build and data spec

[bkeepers]

This adds a new SQLite build, along with a proposed spec for the sqlite schema called "TideBase". A single .tidebase file contains everything needed for tide prediction:

• Station metadata
• Spatial queries (No SQLite extensions required, use plain WHERE on lat/lon columns)
• Harmonic constituents
• Tidal datums, subordinate station offsets
• Precomputed equilibrium arguments and node factors (1970-2100)

README | Spec

Fixes #18

[Copilot]

Pull request overview

Adds a new SQLite (“TideBase”) build target plus a draft schema/spec and validation tests to ensure the SQLite output preserves the existing station dataset.

Changes:

• Introduces a SQLite build script that generates a .tidebase database from existing station JSON data.
• Adds a TideBase schema/spec plus example SQL queries.
• Adds Vitest-based validation tests and a CI job to build + validate the SQLite artifact.

Reviewed changes

Copilot reviewed 17 out of 17 changed files in this pull request and generated 6 comments.

Show a summary per file

File	Description
packages/sqlite/test/sqlite.test.ts	Adds database validation and example-query execution tests.
packages/sqlite/spec.md	Defines the TideBase SQLite specification (draft).
packages/sqlite/schema.sql	Adds the SQLite schema used by the build.
packages/sqlite/package.json	Defines sqlite workspace scripts/deps for building and testing.
packages/sqlite/examples/subordinate-stations.sql	Adds an example query for subordinate stations.
packages/sqlite/examples/station-datums.sql	Adds an example query for station datums.
packages/sqlite/examples/station-constituents.sql	Adds an example query for station constituents.
packages/sqlite/examples/prediction-data.sql	Adds an example query returning prediction inputs for a year.
packages/sqlite/examples/find-nearest.sql	Adds an example “nearest stations” query.
packages/sqlite/examples/find-commercial.sql	Adds example queries for commercially-usable licenses.
packages/sqlite/examples/find-by-id.sql	Adds an example station lookup query by station_id.
packages/sqlite/examples/find-by-country.sql	Adds example queries filtering/counting by country/continent.
packages/sqlite/examples/find-by-bounding-box.sql	Adds an example bounding-box spatial query.
packages/sqlite/build.ts	Implements the SQLite database generator (stations, constituents, offsets, datums, astro tables).
packages/sqlite/build	Adds a shell wrapper to create dist/ and run the build.
packages/sqlite/README.md	Documents TideBase usage and contribution/testing steps.
.github/workflows/ci.yml	Adds a CI job to build and test the sqlite package.

---

💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.

[Copilot]

Opening the SQLite file in beforeAll will throw if the file is missing/corrupt, which prevents the earlier “Database file exists and has reasonable size” assertion from running and producing a more actionable failure. Consider moving the DB open into a hook that runs after a successful existence/size check (or do the existence check inside the hook before instantiating DatabaseSync).

Suggested change

	beforeAll(() => {
	beforeAll(() => {
	// Ensure the database file exists and is reasonably sized before opening.
	expect(existsSync(dbPath)).toBe(true);
	const stats = statSync(dbPath);
	expect(stats.size).toBeGreaterThan(1_000_000); // At least 1MB

[Copilot]

The DatabaseSync handle is never closed, which can keep file descriptors open and cause Vitest to report open handles in some environments. Add an afterAll(() => db.close()) (or equivalent) once all tests complete.

[Copilot]

Using "*" for @neaps/tide-predictor makes installs non-deterministic and can break the build/tests when new versions are published. Prefer a pinned semver range or (if this is a monorepo/workspace dependency) workspace:*.

Suggested change

	"@neaps/tide-predictor": "*"
	"@neaps/tide-predictor": "workspace:*"

[Copilot]

The TideBase spec defines stations.country as an ISO 3166-1 alpha-2 country code, but this example filters by a full country name (“United States”), which is inconsistent and likely to yield no results if the DB follows the spec. Update the example to use the expected code (e.g. US) or adjust the spec/data definition to match the intended stored values.

Suggested change

	WHERE s.country = 'United States'
	WHERE s.country = 'US'