Upgrade Harper to v5 and add integration tests

[BboyAkers]

Summary

• Dependency bump: added harper@^5.0.28 as an explicit dependency (was runtime-provided global). harperdb was never listed in package.json — this repo relied on the global being injected.
• Migration fix: replaced non-standard table.update({ where, data }) call in the ModelFetchJobs retry handler with a v5-compatible table.put({ ...job, ...updates }) (frozen-record-safe spread).
• Integration tests: added integrationTests/data-layer.test.ts using @harperfast/integration-testing@0.4.0. Tests cover the Harper data layer (Model, InferenceEvent, BenchmarkResult, Feature, ModelFetchJob table CRUD + REST resource endpoints + Status health check). AI inference endpoints (Predict/Personalize/Benchmark) require external model files, GPU, or running Ollama — these are exercised only for their data-path error handling in CI.
• CI: added .github/workflows/integration-tests.yml with Node 22/24/26 matrix on ubuntu-latest. Sets MODEL_FETCH_WORKER=false to disable the background model-fetch worker during tests (avoids download attempts).
• Lockfile: regenerated package-lock.json with --os=linux --cpu=x64 --include=optional to include bufferutil, utf-8-validate, and node-gyp-build for Linux CI.
• TypeScript: added tsconfig.json targeting NodeNext with erasableSyntaxOnly for the integration test suite.
• Branding: HarperDB → Harper in README.md, CONTRIBUTING.md, ROADMAP.md, package.json description/author/keywords. Clone URL updated to HarperFast/edge-ai-ops.
• Engines: bumped engines.node to >=22.0.0 (required by @harperfast/integration-testing).

Migration items applied

Item	Status
harperdb → harper import/dep	N/A — runtime-provided global; no explicit import existed
wasLoadedFromSource()	N/A — not used
blob.save()	N/A — not used
Frozen records (no direct property mutation)	Applied — table.update({where,data}) replaced with put({ ...job, ...updates })
Transaction context (getContext())	N/A — no explicit transaction usage
Table.get() return shape	N/A — .wasLoadedFromSource() not called
Process spawning (allowedSpawnCommands)	N/A — no child_process spawn calls

AI inference note

TensorFlow.js, ONNX Runtime, Transformers.js, and Ollama backends require external model files (hundreds of MB) or a running Ollama service. These are not available in CI. The integration tests cover the Harper data layer only, exercising:

• Table CRUD (Model, InferenceEvent, Feature, BenchmarkResult, ModelFetchJob)
• Custom resource endpoints (Status, Predict error path, WorkerControl, ModelList)

Known issues / flagged items

• npm scope: package.json is named harper-edge-ai-example (unscoped). If this should move to the @harperfast/ npm scope, that migration is manual — flagged for human review per org process §11.1.
• Local integration tests: will fail with EADDRNOTAVAIL on macOS (loopback aliases not configured). CI on ubuntu-latest is the test gate.
• Lint warnings: pre-existing prettier/eslint warnings in scripts/ and examples/ are not introduced by this PR. ESLint is not blocking (errors are in scripts, not the Harper app code).

Test results

• Local: blocked by EADDRNOTAVAIL (macOS loopback — environmental, not a code bug)
• CI: running on push — see GitHub Actions for Node 22/24/26 results

🤖 Generated with Claude Code

[gemini-code-assist]

Code Review

This pull request updates the project for Harper v5, renaming references from HarperDB to Harper, bumping the minimum Node.js version to 22, adding a new integration test suite, and refactoring the model fetch job reset logic to avoid frozen-record mutations. Key feedback includes correcting a non-existent TypeScript version in package.json, utilizing native import.meta.resolve in tests, adding defensive checks for the test context, and strengthening test assertions for the /ModelList endpoint.

Important

The consumer version of Gemini Code Assist on GitHub is being sunset. Starting June 18, 2026, new organization installations will be blocked, and all code review activity will officially cease on July 17, 2026.
For more details on the timeline and next steps, please review the Help Documentation.

[BboyAkers]

Review follow-up (autonomous agent): Fixed all 3 blocking findings: coerce ISO-8601 date strings to integer timestamps before retry put in ModelFetchJobs.post (matching ModelFetchWorker.updateJobStatus pattern); guard teardownHarper in after() to surface real startup errors; add test:integration:legacy script to include orphaned tests/integration/ files in CI.