init commit, what could go wrong?

Author: lalalune

.gitignore

@@ -0,0 +1,57 @@
+# Build outputs
+dist/
+node_modules/
+
+# Environment files
+.env
+.env.local
+.env.production
+.env.staging
+.env.development
+.env.bak
+*.env
+
+# OS files
+.DS_Store
+Thumbs.db
+
+# IDE files
+.vscode/
+.idea/
+*.swp
+*.swo
+
+# Logs
+*.log
+npm-debug.log*
+yarn-debug.log*
+yarn-error.log*
+
+# Runtime data
+pids/
+*.pid
+*.seed
+*.pid.lock
+
+# Coverage directory used by tools like istanbul
+coverage/
+
+# Cache directories
+.cache/
+.npm/
+.eslintcache
+
+# Temporary folders
+tmp/
+temp/
+
+# Database files
+*.db
+*.pglite
+*.pglite3
+
+# ElizaOS specific
+.eliza/
+.elizadb/
+pglite/
+cache/

.npmignore

@@ -0,0 +1,5 @@
+.turbo
+node_modules
+.env
+*.env
+.env.local

README.md

@@ -0,0 +1,230 @@
+# ElizaOS Plugin
+
+This is an ElizaOS plugin built with the official plugin starter template.
+
+## Getting Started
+
+```bash
+# Create a new plugin (automatically adds "plugin-" prefix)
+elizaos create -t plugin solana
+# This creates: plugin-solana
+# Dependencies are automatically installed and built
+
+# Navigate to the plugin directory
+cd plugin-solana
+
+# Start development immediately
+elizaos dev
+```
+
+## Development
+
+```bash
+# Start development with hot-reloading (recommended)
+elizaos dev
+
+# OR start without hot-reloading
+elizaos start
+# Note: When using 'start', you need to rebuild after changes:
+# bun run build
+
+# Test the plugin
+elizaos test
+```
+
+## Testing
+
+ElizaOS provides a comprehensive testing structure for plugins:
+
+### Test Structure
+
+- **Component Tests** (`__tests__/` directory):
+
+  - **Unit Tests**: Test individual functions/classes in isolation
+  - **Integration Tests**: Test how components work together
+  - Run with: `elizaos test component`
+
+- **End-to-End Tests** (`e2e/` directory):
+
+  - Test the plugin within a full ElizaOS runtime
+  - Run with: `elizaos test e2e`
+
+- **Running All Tests**:
+  - `elizaos test` runs both component and e2e tests
+
+### Writing Tests
+
+Component tests use Vitest:
+
+```typescript
+// Unit test example (__tests__/plugin.test.ts)
+describe('Plugin Configuration', () => {
+  it('should have correct plugin metadata', () => {
+    expect(starterPlugin.name).toBe('plugin-starter');
+  });
+});
+
+// Integration test example (__tests__/integration.test.ts)
+describe('Integration: HelloWorld Action with StarterService', () => {
+  it('should handle HelloWorld action with StarterService', async () => {
+    // Test interactions between components
+  });
+});
+```
+
+E2E tests use ElizaOS test interface:
+
+```typescript
+// E2E test example (e2e/starter-plugin.test.ts)
+export class StarterPluginTestSuite implements TestSuite {
+  name = 'plugin_starter_test_suite';
+  tests = [
+    {
+      name: 'example_test',
+      fn: async (runtime) => {
+        // Test plugin in a real runtime
+      },
+    },
+  ];
+}
+
+export default new StarterPluginTestSuite();
+```
+
+The test utilities in `__tests__/test-utils.ts` provide mock objects and setup functions to simplify writing tests.
+
+## Publishing & Continuous Development
+
+### Initial Setup
+
+Before publishing your plugin, ensure you meet these requirements:
+
+1. **npm Authentication**
+
+   ```bash
+   npm login
+   ```
+
+2. **GitHub Repository**
+
+   - Create a public GitHub repository for this plugin
+   - Add the 'elizaos-plugins' topic to the repository
+   - Use 'main' as the default branch
+
+3. **Required Assets**
+   - Add images to the `images/` directory:
+     - `logo.jpg` (400x400px square, <500KB)
+     - `banner.jpg` (1280x640px, <1MB)
+
+### Initial Publishing
+
+```bash
+# Test your plugin meets all requirements
+elizaos publish --test
+
+# Publish to npm + GitHub + registry (recommended)
+elizaos publish
+```
+
+This command will:
+
+- Publish your plugin to npm for easy installation
+- Create/update your GitHub repository
+- Submit your plugin to the ElizaOS registry for discoverability
+
+### Continuous Development & Updates
+
+**Important**: After your initial publish with `elizaos publish`, all future updates should be done using standard npm and git workflows, not the ElizaOS CLI.
+
+#### Standard Update Workflow
+
+1. **Make Changes**
+
+   ```bash
+   # Edit your plugin code
+   elizaos dev  # Test locally with hot-reload
+   ```
+
+2. **Test Your Changes**
+
+   ```bash
+   # Run all tests
+   elizaos test
+
+   # Run specific test types if needed
+   elizaos test component  # Component tests only
+   elizaos test e2e       # E2E tests only
+   ```
+
+3. **Update Version**
+
+   ```bash
+   # Patch version (bug fixes): 1.0.0 → 1.0.1
+   npm version patch
+
+   # Minor version (new features): 1.0.1 → 1.1.0
+   npm version minor
+
+   # Major version (breaking changes): 1.1.0 → 2.0.0
+   npm version major
+   ```
+
+4. **Publish to npm**
+
+   ```bash
+   npm publish
+   ```
+
+5. **Push to GitHub**
+   ```bash
+   git push origin main
+   git push --tags  # Push version tags
+   ```
+
+#### Why Use Standard Workflows?
+
+- **npm publish**: Directly updates your package on npm registry
+- **git push**: Updates your GitHub repository with latest code
+- **Automatic registry updates**: The ElizaOS registry automatically syncs with npm, so no manual registry updates needed
+- **Standard tooling**: Uses familiar npm/git commands that work with all development tools
+
+### Alternative Publishing Options (Initial Only)
+
+```bash
+# Publish to npm only (skip GitHub and registry)
+elizaos publish --npm
+
+# Publish but skip registry submission
+elizaos publish --skip-registry
+
+# Generate registry files locally without publishing
+elizaos publish --dry-run
+```
+
+## Configuration
+
+The `agentConfig` section in `package.json` defines the parameters your plugin requires:
+
+```json
+"agentConfig": {
+  "pluginType": "elizaos:plugin:1.0.0",
+  "pluginParameters": {
+    "API_KEY": {
+      "type": "string",
+      "description": "API key for the service"
+    }
+  }
+}
+```
+
+Customize this section to match your plugin's requirements.
+
+## Documentation
+
+Provide clear documentation about:
+
+- What your plugin does
+- How to use it
+- Required API keys or credentials
+- Example usage
+- Version history and changelog

package.json

@@ -0,0 +1,87 @@
+{
+  "name": "@elizaos/plugin-shell",
+  "description": "Shell plugin for ElizaOS",
+  "version": "1.0.0",
+  "type": "module",
+  "private": true,
+  "main": "dist/index.js",
+  "module": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "packageType": "plugin",
+  "platform": "node",
+  "license": "UNLICENSED",
+  "author": "ElizaOS",
+  "keywords": [
+    "plugin",
+    "elizaos"
+  ],
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/elizaos-plugins/plugin-auto"
+  },
+  "homepage": "https://elizaos.ai",
+  "bugs": {
+    "url": "https://github.com/elizaos-plugins/plugin-auto/issues"
+  },
+  "exports": {
+    "./package.json": "./package.json",
+    ".": {
+      "import": {
+        "types": "./dist/index.d.ts",
+        "default": "./dist/index.js"
+      }
+    }
+  },
+  "files": [
+    "dist",
+    "README.md",
+    ".npmignore",
+    "package.json",
+    "tsup.config.ts"
+  ],
+  "dependencies": {
+    "@elizaos/core": "^1.0.9",
+    "@elizaos/plugin-bootstrap": "1.0.8",
+    "zod": "3.24.2"
+  },
+  "peerDependencies": {},
+  "devDependencies": {
+    "@elizaos/cli": "^1.0.0",
+    "dotenv": "16.4.5",
+    "prettier": "3.5.3",
+    "tsup": "8.4.0",
+    "tsx": "^4.7.0",
+    "typescript": "5.8.2",
+    "vitest": "3.1.4"
+  },
+  "scripts": {
+    "start": "elizaos start",
+    "dev": "elizaos dev",
+    "build": "tsup",
+    "lint": "prettier --write ./src",
+    "test:component": "vitest run",
+    "test:e2e": "elizaos test",
+    "test:e2e:local": "tsx src/tests/e2e/run-local.ts",
+    "test": "npm run test:component && npm run test:e2e",
+    "typecheck": "tsc --noEmit",
+    "publish": "elizaos publish",
+    "format": "prettier --write ./src",
+    "format:check": "prettier --check ./src"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "resolutions": {
+    "zod": "3.24.2"
+  },
+  "agentConfig": {
+    "pluginType": "elizaos:plugin:1.0.0",
+    "pluginParameters": {
+      "API_KEY": {
+        "type": "string",
+        "description": "API key for the service"
+      }
+    }
+  },
+  "gitHead": "d5bd5c43bfebeb7ac02f9e029f924cb6cd5c2ec7"
+}