jiva-core 0.2.2 → 0.3.1

package/.dockerignore

@@ -0,0 +1,53 @@
+# Node modules (will be reinstalled)
+node_modules/
+
+# Build outputs (will be rebuilt)
+dist/
+
+# Development files
+*.log
+npm-debug.log*
+yarn-debug.log*
+yarn-error.log*
+.npm
+.eslintcache
+
+# IDE
+.vscode/
+.idea/
+*.swp
+*.swo
+*~
+.DS_Store
+
+# Git
+.git/
+.gitignore
+.gitattributes
+
+# Documentation
+*.md
+!README.md
+docs/
+examples/
+
+# Tests
+test/
+tests/
+*.test.ts
+*.spec.ts
+
+# CI/CD
+.github/
+.gitlab-ci.yml
+.travis.yml
+
+# Local development
+.env
+.env.local
+.env.*.local
+
+# Temporary files
+tmp/
+temp/
+*.tmp

package/.gcloudignore

@@ -0,0 +1,49 @@
+# Google Cloud Build ignore patterns
+# Files not needed in Cloud Build/Container Registry
+
+# Node modules (will be installed in container)
+node_modules/
+
+# Development and docs
+docs/
+examples/
+*.md
+!README.md
+
+# Git
+.git/
+.gitignore
+.gitattributes
+
+# Editor
+.vscode/
+.idea/
+*.swp
+*.swo
+
+# OS
+.DS_Store
+Thumbs.db
+
+# Logs
+*.log
+
+# Build artifacts (will be rebuilt)
+dist/
+*.tsbuildinfo
+
+# Test files
+test/
+tests/
+*.test.ts
+*.test.js
+*.spec.ts
+*.spec.js
+
+# npm package files
+.npmignore
+.npmrc
+
+# Scripts (except deploy.sh which is needed)
+setup.sh
+fix-filesystem-config.js

package/CONTRIBUTING.md

@@ -0,0 +1,92 @@
+# Contributing to Jiva
+
+Thank you for your interest in contributing to Jiva! This document provides guidelines for contributing to the project.
+
+## Code of Conduct
+
+Be respectful and constructive in your interactions with other contributors.
+
+## Getting Started
+
+1. **Fork the repository** on GitHub
+2. **Clone your fork:**
+   ```bash
+   git clone https://github.com/YOUR_USERNAME/Jiva.git
+   cd Jiva
+   ```
+3. **Install dependencies:**
+   ```bash
+   npm install
+   ```
+4. **Build the project:**
+   ```bash
+   npm run build
+   ```
+
+## Development Workflow
+
+See [docs/guides/DEV_WORKFLOW.md](docs/guides/DEV_WORKFLOW.md) for detailed development instructions.
+
+### Quick Commands
+
+```bash
+npm run build              # Compile TypeScript
+npm run dev               # Watch mode for development
+npm run type-check        # Check TypeScript types
+npm test                  # Run tests (when available)
+```
+
+## Making Changes
+
+1. **Create a feature branch:**
+   ```bash
+   git checkout -b feature/your-feature-name
+   ```
+
+2. **Make your changes** following the coding standards
+
+3. **Test your changes:**
+   ```bash
+   npm run build
+   npm link  # Test CLI globally
+   jiva chat  # Verify functionality
+   ```
+
+4. **Commit with clear messages:**
+   ```bash
+   git commit -m "feat: add new feature X"
+   ```
+
+## Coding Standards
+
+- **TypeScript**: All code must be in TypeScript
+- **Formatting**: Follow existing code style
+- **Error Handling**: All functions should handle errors gracefully
+- **Logging**: Use the logger utility for consistent logging
+- **Documentation**: Update docs for new features
+
+## Pull Request Process
+
+1. **Update documentation** for any changed functionality
+2. **Update README.md** if adding new features
+3. **Add release notes** in `docs/release_notes/` if applicable
+4. **Create pull request** with clear description of changes
+5. **Link related issues** in the PR description
+
+## Areas for Contribution
+
+- Bug fixes
+- New MCP server integrations
+- Documentation improvements
+- Performance optimizations
+- Test coverage
+- Storage provider implementations (S3, Redis, etc.)
+- UI/UX improvements for CLI interface
+
+## Questions?
+
+Open an issue on GitHub for any questions about contributing.
+
+## License
+
+By contributing to Jiva, you agree that your contributions will be licensed under the MIT License.

package/Dockerfile

@@ -0,0 +1,63 @@
+# Multi-stage build for Jiva Cloud Run deployment
+# Stage 1: Build
+FROM node:20-alpine AS builder
+
+WORKDIR /app
+
+# Copy package files
+COPY package*.json ./
+COPY tsconfig.json ./
+
+# Install dependencies (including dev dependencies for build)
+RUN npm ci
+
+# Copy source code
+COPY src ./src
+
+# Build TypeScript
+RUN npm run build
+
+# Stage 2: Production
+FROM node:20-alpine
+
+WORKDIR /app
+
+# Install dumb-init for proper signal handling
+RUN apk add --no-cache dumb-init
+
+# Copy package files
+COPY package*.json ./
+
+# Install production dependencies only
+RUN npm ci --omit=dev && npm cache clean --force
+
+# Copy built application from builder
+COPY --from=builder /app/dist ./dist
+
+# Create non-root user
+RUN addgroup -g 1001 -S nodejs && \
+    adduser -S nodejs -u 1001 && \
+    chown -R nodejs:nodejs /app
+
+USER nodejs
+
+# Environment variables (overrideable)
+ENV NODE_ENV=production \
+    PORT=8080 \
+    LOG_LEVEL=info \
+    JIVA_STORAGE_PROVIDER=gcp \
+    MAX_CONCURRENT_SESSIONS=100 \
+    SESSION_IDLE_TIMEOUT_MS=1800000
+
+# Expose port
+EXPOSE 8080
+
+# Health check
+HEALTHCHECK --interval=30s --timeout=5s --start-period=10s --retries=3 \
+  CMD node -e "require('http').get('http://localhost:8080/health', (r) => {process.exit(r.statusCode === 200 ? 0 : 1)})"
+
+# Use dumb-init to handle signals properly
+ENTRYPOINT ["dumb-init", "--"]
+
+# Start HTTP server
+CMD ["node", "dist/interfaces/http/index.js"]

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 KarmaloopAI
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.