Skip to content

Normalize ecosystem repository metadata and knowledge sync schema #316

Description

@animus-launchapp-gitprovider

Context

The live knowledge store has complete coverage for the 192 repositories visible to the current GitHub App installation, but GitHub metadata and the declared knowledge schema are inconsistent.

I corrected the current knowledge descriptions for these records:

  • KNOWLEDGE-115, 119, 120, 127, 128, 131, 141
  • KNOWLEDGE-145, 146, 147, 148, 149, 152
  • KNOWLEDGE-248 through 256

These fixes are vulnerable to being overwritten by the next GitHub sync until upstream repository metadata is corrected.

Upstream metadata work

Remove stale coming v0.4.x / under-construction metadata and update README status/install sections where applicable:

  • animus-protocol
  • animus-plugin-template
  • animus-provider-claude
  • animus-provider-codex
  • animus-provider-gemini
  • animus-provider-oai
  • animus-provider-opencode

Add missing GitHub descriptions for:

  • animus-launchapp
  • animus-mcp-github
  • animus-chat-postgres
  • animus-config-yaml
  • animus-log-storage-s3
  • animus-provider-codex-mcp
  • animus-config-postgres
  • animus-subject-postgres
  • animus-queue-postgres
  • animus-journal-postgres
  • animus-postgres
  • animus-environment-base
  • animus-environment-docker
  • animus-env-transport
  • animus-environment-railway

Recommended canonical descriptions are already present in the corresponding live knowledge records listed above.

Sync/schema work

The built-in knowledge kind declares only entity_kind and url, while synced records also contain repo_full_name, description, language, private, archived, default_branch, pushed_at, source, topics, metadata, and relationships.

Add these fields through a built-in-kind migration so validation and portal rendering match the actual payload. Do not redeclare the built-in kind.

GitHub App follow-up

  • Pin GITHUB_APP_INSTALLATION_ID if organization-wide code search is required.
  • Install or authorize the App for the animus-ecosystem organization, or ingest public plugin-registry entries separately, so external ecosystem repositories can appear in knowledge.
  • Add consistent repository topics such as animus, plugin, provider, subject-backend, workflow, and mcp.

Metadata

Metadata

Assignees

No one assigned

    Labels

    No labels
    No labels

    Type

    No type

    Projects

    No projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions