Publira Agents

Maintenance automation for the Publira organization on GitHub.

Its first application is Chachamaru, the maintenance bot, an eve app deployed to Vercel that hosts the jobs that keep Publira's repositories maintained.

Repository layout

Path	Contents
apps/chachamaru/	Chachamaru, the maintenance bot: the eve agent in agent/, and the deterministic jobs in src/jobs/
packages/devcontainer/	Reading Dev Container configurations, editing their lock files, and resolving Features in OCI registries
packages/github/	GitHub API access
packages/maintenance-policies/	The rules that decide what a job does
packages/npm-registry/	npm registry lookups
packages/pnpm-workspace/	Reading and editing pnpm-workspace.yaml, and the registries .npmrc sets
packages/tsconfig/	The TypeScript configuration every package extends

Development

Open the repository in the Dev Container, or use Node.js and pnpm at the versions pinned in package.json. Then run these from the repository root:

pnpm install
pnpm build      # build the packages and the apps
pnpm typecheck
pnpm test
pnpm check      # lint and format checks; `pnpm fix` applies the fixes

Each app's README describes how to run and operate it.

AGENTS.md describes the conventions in more detail.

License

Apache License 2.0