Skip to content

Staging#561

Merged
equationalapplications merged 8 commits into
mainfrom
staging
Jul 14, 2026
Merged

Staging#561
equationalapplications merged 8 commits into
mainfrom
staging

Conversation

@equationalapplications

Copy link
Copy Markdown
Owner

Description

Adopts the curated Schema.org ontology manifest (@equationalapplications/schema-org-llm-wiki@4.22.0) for Clanker's warm-agent memory system. Seeds the 9-node, 28-edge manifest for cloud characters during sync, and bumps wiki packages to 4.22.0 for triple-keyed edge validation support.

Spec: docs/superpowers/specs/2026-07-14-curated-schema-ontology-design.md

Type of Change

  • New feature (non-breaking change which adds functionality)

Related Issue

Fixes #

Changes Made

  • Bump @equationalapplications/expo-llm-wiki and @equationalapplications/core-llm-wiki to 4.22.0; add @equationalapplications/schema-org-llm-wiki@^4.22.0
  • Seed schemaOrgWarmAgentManifest for cloud characters during sync when no manifest exists locally or in the cloud bundle
  • Design spec and implementation plan for the curated Schema.org ontology adoption

Testing

Platforms Tested

  • iOS
  • Android
  • Web

Test Steps

  1. Sync a new cloud character with no stored manifest → verify schemaOrgWarmAgentManifest is seeded in strict mode
  2. Sync a character with an existing manifest → verify seed is skipped, existing manifest wins
  3. Verify backfill classifies pre-ontology facts against the seeded manifest

equationalapplications and others added 6 commits July 14, 2026 15:40
…wiki 4.22.0

The manifest now ships as @equationalapplications/schema-org-llm-wiki
(published 4.22.0); this spec becomes Clanker's adoption design instead
of an inline manifest definition. Updates: rating→review, attendee,
subOrganization, polymorphic edge rows kept (triple-keyed validation in
core 4.22.0), deployment path grounded in characterSyncService seeding
and existing cloud sync.

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
feat: adopt curated Schema.org ontology manifest for warm-agent memory

Copilot AI left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Pull request overview

This PR adopts the curated Schema.org ontology manifest package for Clanker’s warm-agent memory system by bumping wiki dependencies to 4.22.0, adding the @equationalapplications/schema-org-llm-wiki manifest package, and seeding the manifest during cloud character sync so ontology backfill can run in strict mode.

Changes:

  • Bump @equationalapplications/*-llm-wiki deps to ^4.22.0 and add @equationalapplications/schema-org-llm-wiki@^4.22.0.
  • Seed schemaOrgWarmAgentManifest (strict mode) for cloud-linked characters that have no ontology manifest after sync.
  • Add Jest coverage for seeding behavior + add design spec and implementation plan docs.

Reviewed changes

Copilot reviewed 5 out of 6 changed files in this pull request and generated 1 comment.

Show a summary per file
File Description
src/services/characterSyncService.ts Seeds the curated ontology manifest post-sync (before backfill) for cloud-linked characters with no manifest.
tests/characterSyncWiki.test.ts Adds mocks and tests covering seeding, skip-when-present, failure reporting, and multi-character behavior.
package.json Bumps wiki deps and adds the schema-org manifest package dependency.
package-lock.json Lockfile updates for the bumped/added packages.
docs/superpowers/specs/2026-07-14-curated-schema-ontology-design.md Adds the design spec for the curated Schema.org ontology adoption.
docs/superpowers/plans/2026-07-14-schema-org-ontology-adoption.md Adds an implementation plan documenting the intended rollout and tests.

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

Comment thread src/services/characterSyncService.ts
Co-authored-by: Copilot Autofix powered by AI <175728472+Copilot@users.noreply.github.com>
Signed-off-by: Kurt VanDusen <info@equationalapplications.com>
@coderabbitai

coderabbitai Bot commented Jul 14, 2026

Copy link
Copy Markdown

Review Change Stack

No actionable comments were generated in the recent review. 🎉

ℹ️ Recent review info
⚙️ Run configuration

Configuration used: Organization UI

Review profile: CHILL

Plan: Pro

Run ID: 98181f9b-bb6d-4e48-91bd-5376f343cba0

📥 Commits

Reviewing files that changed from the base of the PR and between 201aa8b and d55c3f5.

📒 Files selected for processing (3)
  • __tests__/characterSyncWiki.test.ts
  • docs/superpowers/plans/2026-07-14-schema-org-ontology-adoption.md
  • docs/superpowers/specs/2026-07-14-curated-schema-ontology-design.md
🚧 Files skipped from review as they are similar to previous changes (3)
  • docs/superpowers/specs/2026-07-14-curated-schema-ontology-design.md
  • docs/superpowers/plans/2026-07-14-schema-org-ontology-adoption.md
  • tests/characterSyncWiki.test.ts

📝 Walkthrough

Summary by CodeRabbit

  • New Features

    • Cloud characters now automatically receive the curated Schema.org “warm agent” ontology when no ontology manifest is configured (strict-mode seeding).
    • Existing ontology manifests are preserved; seeding occurs only for characters missing manifests.
    • Seed failures are reported with a dedicated wiki:<id>:ontology:seed context while sync/backfill continues, including safe handling of busy states.
  • Documentation

    • Added end-to-end implementation plan and design/spec for Schema.org “warm agent” ontology adoption.
  • Tests

    • Added Jest coverage for seeding behavior, skip-when-present logic, fail-soft reporting, and not overwriting manifests written during restore.
  • Chores

    • Updated wiki package dependencies to version 4.22.0 and added the Schema.org ontology package.

Walkthrough

The PR adds a curated Schema.org ontology package, seeds missing manifests during cloud character sync, preserves ontology backfill after seed failures, and adds Jest coverage plus design and implementation documentation.

Changes

Schema.org ontology adoption

Layer / File(s) Summary
Ontology contract and package wiring
docs/superpowers/specs/..., docs/superpowers/plans/..., package.json
Defines the 9-node, 28-edge curated ontology and updates wiki dependencies to version 4.22.0.
Character sync manifest seeding
src/services/characterSyncService.ts, docs/superpowers/...
Seeds schemaOrgWarmAgentManifest in strict mode when a cloud character has no manifest, while reporting non-busy failures and continuing backfill.
Seeding validation and rollout checks
__tests__/characterSyncWiki.test.ts, docs/superpowers/...
Adds mocks and tests for seeding, skipping, failure reporting, ordering, and independent character handling, with rollout instructions.

Estimated code review effort: 3 (Moderate) | ~20 minutes

Sequence Diagram(s)

sequenceDiagram
  participant SyncAllToCloud
  participant Wiki
  participant Backfill
  participant ErrorReporter
  SyncAllToCloud->>Wiki: Read character ontology manifest
  SyncAllToCloud->>Wiki: Seed curated manifest in strict mode
  SyncAllToCloud->>Backfill: Run ontology backfill
  SyncAllToCloud->>ErrorReporter: Report seed failure
Loading

Possibly related PRs

Poem

A rabbit hops through schemas bright,
Seeds warm agents left and right.
Strict little graphs take root,
Backfill follows every route.
If one fails, the rest still run—
Ontology sync has begun!

🚥 Pre-merge checks | ✅ 4 | ❌ 1

❌ Failed checks (1 inconclusive)

Check name Status Explanation Resolution
Title check ❓ Inconclusive The title is too vague and does not describe the actual changes in the pull request. Rename it to a concise, specific summary of the main change, such as seeding the Schema.org ontology manifest and bumping wiki packages.
✅ Passed checks (4 passed)
Check name Status Explanation
Description check ✅ Passed The description covers the required sections and clearly explains the change, type, related issue, changes, and testing.
Docstring Coverage ✅ Passed No functions found in the changed files to evaluate docstring coverage. Skipping docstring coverage check.
Linked Issues check ✅ Passed Check skipped because no linked issues were found for this pull request.
Out of Scope Changes check ✅ Passed Check skipped because no linked issues were found for this pull request.
✨ Finishing Touches
📝 Generate docstrings
  • Create stacked PR
  • Commit on current branch

Comment @coderabbitai help to get the list of available commands.

@coderabbitai coderabbitai Bot left a comment

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Actionable comments posted: 3

🧹 Nitpick comments (1)
__tests__/characterSyncWiki.test.ts (1)

555-635: 🎯 Functional Correctness | 🔵 Trivial | ⚡ Quick win

Test cloud-restored manifest precedence.

This suite sets mockSyncAll.mockResolvedValue(undefined), so it never executes the runRemoteSync path that restores cloudBundle.ontology. Add a test where sync returns a cloud manifest and verify the later seed check skips overwriting it.

🤖 Prompt for AI Agents
Verify each finding against current code. Fix only still-valid issues, skip the
rest with a brief reason, keep changes minimal, and validate.

In `@__tests__/characterSyncWiki.test.ts` around lines 555 - 635, Add a test in
the ontology manifest seeding suite that makes mockSyncAll return a cloud bundle
containing an ontology manifest, then runs syncAllToCloud and verifies the
subsequent seed check does not call mockSetOntologyManifest. Ensure the test
covers restoration through the runRemoteSync path and confirms the restored
cloud manifest takes precedence over schemaOrgWarmAgentManifest.
🤖 Prompt for all review comments with AI agents
Verify each finding against current code. Fix only still-valid issues, skip the
rest with a brief reason, keep changes minimal, and validate.

Inline comments:
In `@docs/superpowers/plans/2026-07-14-schema-org-ontology-adoption.md`:
- Line 17: Update the task section headings in the plan document from
level-three to level-two headings, including Task 1 through Task 4 and
Self-Review Notes, so they directly follow the document’s level-one title.
- Around line 48-54: Update the “Step 4: Verify nothing broke” section to
replace the separate typecheck and targeted test commands with the required
exact command: npm run typecheck && npm run lint && npm run test. Remove the
outdated expected-output and baseline-test instructions while preserving the
step’s verification purpose.

In `@docs/superpowers/specs/2026-07-14-curated-schema-ontology-design.md`:
- Around line 154-156: Update the “Where the manifest lives at runtime” section
to remove the inaccurate claim that no manifest is seeded and all characters
resolve to mode “off.” Describe the current shipped seed behavior, or qualify
the statement as applying only before ontology adoption, while preserving the
existing sync-path description.

---

Nitpick comments:
In `@__tests__/characterSyncWiki.test.ts`:
- Around line 555-635: Add a test in the ontology manifest seeding suite that
makes mockSyncAll return a cloud bundle containing an ontology manifest, then
runs syncAllToCloud and verifies the subsequent seed check does not call
mockSetOntologyManifest. Ensure the test covers restoration through the
runRemoteSync path and confirms the restored cloud manifest takes precedence
over schemaOrgWarmAgentManifest.
🪄 Autofix (Beta)

Fix all unresolved CodeRabbit comments on this PR:

  • Push a commit to this branch (recommended)
  • Create a new PR with the fixes

ℹ️ Review info
⚙️ Run configuration

Configuration used: Organization UI

Review profile: CHILL

Plan: Pro

Run ID: ebe9fc38-5004-4a5d-a157-43893913768f

📥 Commits

Reviewing files that changed from the base of the PR and between 9d2cd48 and 201aa8b.

⛔ Files ignored due to path filters (1)
  • package-lock.json is excluded by !**/package-lock.json
📒 Files selected for processing (5)
  • __tests__/characterSyncWiki.test.ts
  • docs/superpowers/plans/2026-07-14-schema-org-ontology-adoption.md
  • docs/superpowers/specs/2026-07-14-curated-schema-ontology-design.md
  • package.json
  • src/services/characterSyncService.ts

Comment thread docs/superpowers/plans/2026-07-14-schema-org-ontology-adoption.md Outdated
Comment thread docs/superpowers/plans/2026-07-14-schema-org-ontology-adoption.md Outdated
Comment thread docs/superpowers/specs/2026-07-14-curated-schema-ontology-design.md Outdated
- Add seeding test that drives runRemoteSync with a cloud ontology bundle
  and asserts the seed check defers to the restored manifest
- Plan doc: task headings h3 -> h2 (MD001), verification steps use the
  required `npm run typecheck && npm run lint && npm run test` command
- Spec doc: qualify pre-adoption "no manifest seeded" wording now that
  the seed path has shipped

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
@equationalapplications

Copy link
Copy Markdown
Owner Author

/fix-pr follow-up

Commit: d55c3f5deb2795d05836a46e63309cccf7f42826

Review resolution

  • Plan doc — heading levels (MD001): Fixed — Task 1–4 headings changed ##### (Self-Review Notes was already h2). (docs/superpowers/plans/2026-07-14-schema-org-ontology-adoption.md)
  • Plan doc — required verification command: Fixed — Task 1 Step 4 and Task 3 now use the exact npm run typecheck && npm run lint && npm run test chain per AGENTS.md; Task 3 steps renumbered. (same file)
  • Spec doc — pre-adoption wording: Fixed — "No manifest is seeded anywhere today" qualified as pre-adoption state, with the shipped seed behavior described. (docs/superpowers/specs/2026-07-14-curated-schema-ontology-design.md:156)
  • Test nitpick — cloud-restored manifest precedence: Fixed — new test drives runRemoteSync via a mockSyncAll implementation returning a cloud bundle with an ontology; asserts the restored manifest is written once and the seed check skips overwriting it with schemaOrgWarmAgentManifest. (tests/characterSyncWiki.test.ts)

Verification

  • typecheck — pass (npm run typecheck)
  • lint — pass (npm run lint:check)
  • tests — pass, 121 suites / 997 tests (npm run test)

@equationalapplications
equationalapplications merged commit 1e0c8d4 into main Jul 14, 2026
6 checks passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants