{
  "interval": {
    "intervalStart": "2025-07-23T00:00:00.000Z",
    "intervalEnd": "2025-07-24T00:00:00.000Z",
    "intervalType": "day"
  },
  "repository": "elizaos/eliza",
  "overview": "From 2025-07-23 to 2025-07-24, elizaos/eliza had 3 new PRs (1 merged), 1 new issues, and 7 active contributors.",
  "topIssues": [
    {
      "id": "I_kwDOMT5cIs7CKuPQ",
      "title": "Link to download whole docs in new docs site",
      "author": "borisudovicic",
      "number": 5672,
      "repository": "elizaos/eliza",
      "body": "llm.txt",
      "createdAt": "2025-07-23T20:16:53Z",
      "closedAt": "2025-07-25T08:17:35Z",
      "state": "CLOSED",
      "commentCount": 0
    }
  ],
  "topPRs": [
    {
      "id": "PR_kwDOMT5cIs6gRJJ1",
      "title": "feature/docker starter",
      "author": "bealers",
      "number": 5670,
      "body": "# Docker Infrastructure for elizaOS - foundation stage\r\n\r\nAdds Docker support with CLI integration and organized target structure for both starter projects and monorepo development.\r\n\r\n## New Commands\r\n\r\n```bash\r\n# Development with hot reload\r\nelizaos dev --docker\r\n\r\n# Production deployment  \r\nelizaos start --docker\r\n```\r\n\r\n## How It Works\r\n\r\n### Starter Project Context\r\nWhen using `elizaos create my-project`, the generated project includes Docker configs:\r\n\r\n```bash\r\nelizaos create my-project\r\ncd my-project\r\nelizaos dev --docker    # Starts containerized dev environment\r\nelizaos start --docker  # Starts production-ready container\r\n```\r\n\r\n**Benefits:**\r\n- **Consistent environments** across team members\r\n- **No local dependency conflicts** (Node versions, system packages)\r\n- **One-command setup** for new developers\r\n- **Production-like testing** locally\r\n\r\n### Monorepo Context\r\nFor ElizaOS core development, use organized Docker targets:\r\n\r\n```bash\r\n# Development\r\ncd docker/targets/dev && docker-compose up\r\n\r\n# Production\r\ncd docker/targets/prod && docker-compose up\r\n\r\n# Documentation\r\ncd docker/targets/docs && docker-compose up\r\n```\r\n## Structure\r\n\r\n```\r\ndocker/targets/\r\n├── dev/     # Development: hot reload, debug ports, volume mounting\r\n├── prod/    # Production: optimized builds, health checks, PostgreSQL\r\n└── docs/    # Documentation: fast nginx serving\r\n```\r\n\r\n## Testing\r\n\r\n```bash\r\ncd docker/tests && bun test\r\n\r\n# Test CLI integration\r\nelizaos create test-project\r\ncd test-project\r\nelizaos dev --docker\r\n```\r\n\r\n## Compatibility\r\n\r\n- No breaking changes\r\n- TEE functionality preserved (`tee-docker-compose.yaml`)\r\n- Project starter templates include Docker configs \r\n\r\n## Next\r\n\r\n- reduce prod image size futher, use `docker-slim`\r\n- take prod image and apply to docker registry\r\n- build out `elizaos deploy`, or similar\r\n- document popular providers, Railway, Digital Ocean, Hetzner",
      "repository": "elizaos/eliza",
      "createdAt": "2025-07-23T13:15:34Z",
      "mergedAt": null,
      "additions": 4053,
      "deletions": 177
    },
    {
      "id": "PR_kwDOMT5cIs6gP4D-",
      "title": "docs: Add AGENT.md development guide",
      "author": "wtfsayo",
      "number": 5669,
      "body": "## Description\n\nThis PR adds a new AGENT.md file that serves as a quick reference guide for ElizaOS agent development.\n\n## Changes\n- Added comprehensive build/test command reference\n- Documented core architecture and dependencies\n- Defined code style guidelines and best practices\n- Outlined component types (Actions, Providers, Services, Evaluators)\n\n## Purpose\nThis guide provides developers with a concise reference for:\n- Common build and test commands\n- Architecture overview and key packages\n- Code style conventions specific to ElizaOS\n- Understanding of different component types\n\nThe format is optimized for quick scanning and reference during development.",
      "repository": "elizaos/eliza",
      "createdAt": "2025-07-23T11:29:25Z",
      "mergedAt": "2025-07-23T12:00:39Z",
      "additions": 29,
      "deletions": 0
    },
    {
      "id": "PR_kwDOMT5cIs6f70UI",
      "title": "fix: update zod to 3.25 so v3 is there",
      "author": "yungalgo",
      "number": 5658,
      "body": "### Problem\r\nWhen running `elizaos publish` on a newly created plugin, users encounter a module resolution error:\r\n\r\n```bash\r\nerror: Cannot find module 'zod/v3' from '/Users/user/plugin-testing/node_modules/@langchain/core/dist/runnables/base.js'\r\n```\r\n\r\n### Root Cause Analysis\r\nThe error occurs due to a version mismatch between dependencies:\r\n\r\n1. **@langchain/core v0.3.66** imports from `zod/v3`:\r\n   ```javascript\r\n   // @langchain/core/dist/runnables/base.js\r\n   import { z } from \"zod/v3\";\r\n   ```\r\n\r\n2. **Plugin templates** were pinning zod to older versions:\r\n   - `plugin-starter`: zod `3.24.2`\r\n   - `plugin-quick-starter`: zod `^3.24.4`\r\n\r\n3. **The `/v3` export** was added in zod `3.25.0`, so older versions don't have it\r\n\r\n4. **@langchain/core** requires `zod ^3.25.32` in its package.json\r\n\r\n### Solution\r\nUpdated the zod version in both plugin templates to match @langchain/core's requirements:\r\n\r\n```diff\r\n// plugin-starter/package.json\r\n  \"dependencies\": {\r\n    \"@elizaos/core\": \"workspace:*\",\r\n-   \"zod\": \"3.24.2\"\r\n+   \"zod\": \"^3.25.32\"\r\n  },\r\n  \"resolutions\": {\r\n-   \"zod\": \"3.24.2\"\r\n+   \"zod\": \"^3.25.32\"\r\n  }\r\n```\r\n\r\n```diff\r\n// plugin-quick-starter/package.json\r\n  \"dependencies\": {\r\n    \"@elizaos/core\": \"workspace:*\",\r\n-   \"zod\": \"^3.24.4\"\r\n+   \"zod\": \"^3.25.32\"\r\n  },\r\n  \"resolutions\": {\r\n-   \"zod\": \"^3.24.4\"\r\n+   \"zod\": \"^3.25.32\"\r\n  }\r\n```\r\n\r\n### Testing\r\nAfter this change, `elizaos publish` runs without module resolution errors on newly created plugins.\r\n\r\nFixes #5657 \n\n<!-- This is an auto-generated comment: release notes by coderabbit.ai -->\n\n## Summary by CodeRabbit\n\n* **Chores**\n  * Updated the \"zod\" dependency to version ^3.25.32 in relevant packages for improved compatibility and maintenance.\n\n<!-- end of auto-generated comment: release notes by coderabbit.ai -->",
      "repository": "elizaos/eliza",
      "createdAt": "2025-07-21T21:45:16Z",
      "mergedAt": null,
      "additions": 20,
      "deletions": 23
    },
    {
      "id": "PR_kwDOMT5cIs6gToNY",
      "title": "Synchronize zod version across project",
      "author": "wtfsayo",
      "number": 5671,
      "body": "```\n<!-- Use this template by filling in information and copying and pasting relevant items out of the HTML comments. -->\n\n# Relates to\n\nN/A\n\n# Risks\n\nLow. This change aligns Zod versions across the project, reducing potential runtime errors.\n\n# Background\n\n## What does this PR do?\n\nUpdates the Zod dependency and resolution in the root `llms.txt` file from `^3.25.32` to `^4.0.5`.\n\n## What kind of change is this?\n\nBug fixes\n\n## Why are we doing this? Any context or related work?\n\nThe project had an inconsistent Zod versioning: the root `llms.txt` specified Zod `^3.25.32`, while all other `package.json` files were updated to Zod `^4.0.5`. This mismatch, combined with code changes that use the Zod v4 API (`error.issues` instead of `error.errors`), would cause runtime errors when Zod validation failed, as Zod v3 does not have the `issues` property. This PR resolves the inconsistency.\n\n# Documentation changes needed?\n\nMy changes do not require a change to the project documentation.\n\n# Testing\n\n## Where should a reviewer start?\n\n`llms.txt`\n\n## Detailed testing steps\n\nNone: Automated tests are acceptable.\n```\n\n---\n\n[Open in Web](https://www.cursor.com/agents?id=bc-bdc67ad7-7806-476f-8e18-12b22c963797) • [Open in Cursor](https://cursor.com/background-agent?bcId=bc-bdc67ad7-7806-476f-8e18-12b22c963797)",
      "repository": "elizaos/eliza",
      "createdAt": "2025-07-23T16:56:51Z",
      "mergedAt": null,
      "additions": 2,
      "deletions": 2
    }
  ],
  "codeChanges": {
    "additions": 29,
    "deletions": 0,
    "files": 1,
    "commitCount": 12
  },
  "completedItems": [
    {
      "title": "docs: Add AGENT.md development guide",
      "prNumber": 5669,
      "type": "docs",
      "body": "## Description\n\nThis PR adds a new AGENT.md file that serves as a quick reference guide for ElizaOS agent development.\n\n## Changes\n- Added comprehensive build/test command reference\n- Documented core architecture and dependencies\n- Defined ",
      "files": [
        "AGENT.md"
      ]
    }
  ],
  "topContributors": [
    {
      "username": "ChristopherTrimboli",
      "avatarUrl": "https://avatars.githubusercontent.com/u/27584221?u=0d816ce1dcdea8f925aba18bb710153d4a87a719&v=4",
      "totalScore": 69.1495477931522,
      "prScore": 68.80954779315219,
      "issueScore": 0,
      "reviewScore": 0,
      "commentScore": 0.33999999999999997,
      "summary": "ChristopherTrimboli: Focused on documentation improvements, opening two PRs (elizaos-plugins/plugin-solana#12, elizaos-plugins/plugin-solana#11) to update the README with comprehensive documentation, reflecting a primary focus on docs work."
    },
    {
      "username": "bealers",
      "avatarUrl": "https://avatars.githubusercontent.com/u/6403055?u=8c40778251e25b92cdee727056415b6c0d1bcdc5&v=4",
      "totalScore": 39.2797738965761,
      "prScore": 39.2797738965761,
      "issueScore": 0,
      "reviewScore": 0,
      "commentScore": 0,
      "summary": "bealers: Focused on feature work, docs, and bug fixes, opening a significant new feature PR, elizaos/eliza#5670 \"feature/docker starter\", which involved modifying 48 files with substantial code changes (+3044/-930 lines). Their work primarily touched code, tests, config, and documentation files."
    },
    {
      "username": "wtfsayo",
      "avatarUrl": "https://avatars.githubusercontent.com/u/82053242?u=98209a1f10456f42d4d2fa71db4d5bf4a672cbc3&v=4",
      "totalScore": 32.88031764704813,
      "prScore": 32.44231764704813,
      "issueScore": 0,
      "reviewScore": 0,
      "commentScore": 0.43799999999999994,
      "summary": "wtfsayo: Focused on improving documentation, merging PR elizaos/eliza#5669 which added a development guide for agents, and also initiated a project-wide synchronization of the Zod version. Their work primarily involved documentation and other general tasks."
    },
    {
      "username": "github-advanced-security",
      "avatarUrl": "https://avatars.githubusercontent.com/in/57789?v=4",
      "totalScore": 4.5,
      "prScore": 0,
      "issueScore": 0,
      "reviewScore": 4.5,
      "commentScore": 0,
      "summary": "github-advanced-security: No activity today."
    },
    {
      "username": "borisudovicic",
      "avatarUrl": "https://avatars.githubusercontent.com/u/31806472?u=27713fbe603baae91ef519990facbacd6c23e93d&v=4",
      "totalScore": 2,
      "prScore": 0,
      "issueScore": 2,
      "reviewScore": 0,
      "commentScore": 0,
      "summary": "borisudovicic: Created an issue to improve documentation accessibility, specifically requesting a download option for the entire documentation on the new docs site (elizaos/eliza#5672)."
    }
  ],
  "newPRs": 3,
  "mergedPRs": 1,
  "newIssues": 1,
  "closedIssues": 0,
  "activeContributors": 7
}