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

    Fields

    No fields configured for issues without a type.

    Projects

    No projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions