@trace.market/types 0.1.0

package/.github/workflows/build-mcp.yml

@@ -0,0 +1,36 @@
+name: Build MCP Server
+
+on:
+  push:
+    branches:
+      - main
+    paths:
+      - 'mcp-server/**'
+  pull_request:
+    paths:
+      - 'mcp-server/**'
+
+jobs:
+  build:
+    runs-on: ubuntu-latest
+    
+    steps:
+      - uses: actions/checkout@v4
+      
+      - uses: actions/setup-node@v4
+        with:
+          node-version: '20'
+      
+      - name: Install dependencies
+        working-directory: ./mcp-server
+        run: npm install
+      
+      - name: Build MCP server
+        working-directory: ./mcp-server
+        run: npm run build
+      
+      - name: Upload build artifacts
+        uses: actions/upload-artifact@v4
+        with:
+          name: mcp-server-dist
+          path: mcp-server/dist/

package/.github/workflows/publish.yml

@@ -0,0 +1,72 @@
+name: Publish to NPM
+
+on:
+  push:
+    branches:
+      - main
+    paths:
+      - 'src/**'
+      - 'package.json'
+  workflow_dispatch:
+
+jobs:
+  publish:
+    runs-on: ubuntu-latest
+    permissions:
+      contents: write
+      packages: write
+    
+    steps:
+      - uses: actions/checkout@v4
+        with:
+          fetch-depth: 0
+      
+      - uses: actions/setup-node@v4
+        with:
+          node-version: '20'
+          registry-url: 'https://registry.npmjs.org'
+      
+      - name: Install dependencies
+        run: npm install
+      
+      - name: Validate types
+        run: npm run validate
+      
+      - name: Check if version changed
+        id: check
+        run: |
+          git fetch --tags
+          CURRENT_VERSION=$(node -p "require('./package.json').version")
+          if git rev-parse "v$CURRENT_VERSION" >/dev/null 2>&1; then
+            echo "Version $CURRENT_VERSION already exists"
+            echo "changed=false" >> $GITHUB_OUTPUT
+          else
+            echo "New version $CURRENT_VERSION"
+            echo "changed=true" >> $GITHUB_OUTPUT
+            echo "version=$CURRENT_VERSION" >> $GITHUB_OUTPUT
+          fi
+      
+      - name: Publish to NPM
+        if: steps.check.outputs.changed == 'true'
+        run: npm publish --access public
+        env:
+          NODE_AUTH_TOKEN: ${{ secrets.NPM_TOKEN }}
+      
+      - name: Create Git tag
+        if: steps.check.outputs.changed == 'true'
+        run: |
+          git config user.name "GitHub Actions"
+          git config user.email "actions@github.com"
+          git tag "v${{ steps.check.outputs.version }}"
+          git push origin "v${{ steps.check.outputs.version }}"
+      
+      - name: Create GitHub Release
+        if: steps.check.outputs.changed == 'true'
+        uses: actions/create-release@v1
+        env:
+          GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
+        with:
+          tag_name: v${{ steps.check.outputs.version }}
+          release_name: Release v${{ steps.check.outputs.version }}
+          draft: false
+          prerelease: false

package/IMPLEMENTATION.md

@@ -0,0 +1,199 @@
+# Implementation Summary
+
+## ✅ Completed Setup
+
+### 1. Package Configuration
+- **Name changed**: `@fairfooddata/types` → `@trace.market/types`
+- **Version**: 0.1.0
+- **License**: MIT (was UNLICENSED)
+- **Repository**: Linked to https://github.com/entin-hun/tm-types
+- **Scripts**: Added validation, versioning, and publishing workflows
+
+### 2. MCP Server Created
+Location: `mcp-server/`
+
+**Features Implemented:**
+
+#### For Authenticated Users (Admin/User)
+- ✅ `create_type_from_description` - Natural language type creation
+- ✅ `add_type_definition` - Direct TypeScript type addition
+- ✅ JWT-based authentication with role checking
+
+#### For All Users (Including Anonymous)
+- ✅ `list_types` - Browse all type definitions
+- ✅ `get_type_definition` - View detailed type information
+- ✅ `validate_data` - Check data against types
+- ✅ `query_data` - Query with filters
+- ✅ `generate_report` - Create reports in JSON/Markdown/HTML
+
+### 3. CI/CD Pipelines
+Created `.github/workflows/`:
+- **publish.yml** - Automatic npm publishing on version changes
+- **build-mcp.yml** - MCP server build verification
+
+**Publishing Flow:**
+1. Developer updates version in package.json
+2. Push to main branch
+3. GitHub Actions validates TypeScript
+4. If version changed, publishes to npm
+5. Creates git tag and GitHub release
+
+### 4. Documentation
+- **README.md** - Main package documentation
+- **mcp-server/README.md** - MCP server guide
+- **QUICKSTART.md** - Step-by-step setup instructions
+- **mcp-config.example.json** - Example Copilot configuration
+
+### 5. Tooling
+- **generate-token.js** - JWT token generator for auth operations
+- **.env.example** - Environment configuration template
+- **tsconfig.json** - TypeScript configuration
+- **.gitignore** - Proper exclusions for dist/, node_modules/, .env
+
+## 📦 Current Type Definitions
+
+All types from `@fairfooddata/types@0.0.6` are preserved:
+- Pokedex, ProductInstance, FoodInstance, CartridgeInstance
+- Process types: Milling, Printing, FreezeDrying, Blending, Sale, Harvest
+- Supply chain: Transport, Facility, Location, InputInstance
+- Environmental: CarbonImpact, WaterImpact
+- Supporting: Price, KnowHow, MachineInstance, etc.
+
+## 🚀 Usage
+
+### Install Package
+```bash
+npm install @trace.market/types
+```
+
+### Configure MCP in Copilot
+```json
+{
+  "mcpServers": {
+    "tm-types": {
+      "command": "node",
+      "args": ["/path/to/tm-types/mcp-server/dist/index.js"],
+      "env": {
+        "JWT_SECRET": "your-secret-key"
+      }
+    }
+  }
+}
+```
+
+### Generate Auth Token
+```bash
+cd mcp-server
+JWT_SECRET="your-secret" node generate-token.js userId role
+```
+
+### Example Copilot Interactions
+
+**List types (no auth):**
+> "Show me all food-related types"
+
+**Create new type (auth required):**
+> "Create an OrganicCertification type with certifier, issueDate, expiryDate fields. Token: [paste]"
+
+**Validate data (no auth):**
+> "Check if this is a valid FoodInstance: {category: 'food', bio: true, quantity: 1000}"
+
+**Generate report (no auth):**
+> "Generate an impact report for this product data"
+
+## 🔄 Migration Path
+
+### For Projects Using `@fairfooddata/types`
+
+1. **Update dependencies:**
+   ```bash
+   npm uninstall @fairfooddata/types
+  npm install @trace.market/types
+   ```
+
+2. **Find & replace imports:**
+   ```typescript
+   // Old
+   import { FoodInstance } from '@fairfooddata/types';
+   
+   // New
+  import { FoodInstance } from '@trace.market/types';
+   ```
+
+3. **Test builds:**
+   ```bash
+   npm run build  # or quasar build, etc.
+   ```
+
+### Affected Projects
+- tm-editor (version 0.0.9)
+- tm-marketplace (version 0.0.6)
+- tm-list (version 0.0.4)
+- tm-savedvalues (version 0.0.6)
+- tm-package-page buy (version 0.0.6)
+
+## 🎯 Key Benefits
+
+1. **Self-Service**: No dependency on ex-developer's npm account
+2. **Automation**: Hourly updates possible with CI/CD
+3. **Natural Language**: Non-technical users can add types via Copilot
+4. **Public Access**: Anonymous users can query/validate data
+5. **Transcription-Ready**: Works with chatbots and voice interfaces
+6. **Version Control**: All changes tracked in git
+7. **Authenticated Writes**: Only authorized users modify types
+
+## 📝 Next Steps
+
+### Immediate
+1. Set up npm account and generate NPM_TOKEN
+2. Add NPM_TOKEN to GitHub repository secrets
+3. Generate production JWT_SECRET
+4. Test first publish: `npm version patch && git push`
+
+### Near Term
+1. Migrate tm-editor to use @trace.market/types
+2. Migrate other projects (tm-marketplace, tm-list, etc.)
+3. Document new types that need to be added
+4. Set up user authentication system for MCP
+
+### Future Enhancements
+1. Integrate real LLM API for better natural language processing
+2. Add database persistence for type change history
+3. Create web UI for type browsing
+4. Add TypeScript code generation from types
+5. Implement real-time collaboration on type definitions
+
+## 🧪 Testing Checklist
+
+- [x] Package builds successfully
+- [x] MCP server compiles
+- [x] Token generation works
+- [x] Type definitions validate
+- [ ] First npm publish
+- [ ] MCP integration with Copilot
+- [ ] Anonymous type queries
+- [ ] Authenticated type creation
+- [ ] CI/CD pipeline execution
+
+## 📚 Documentation Files
+
+- `/README.md` - Main package README
+- `/QUICKSTART.md` - Setup and usage guide
+- `/mcp-server/README.md` - MCP server documentation
+- `/mcp-config.example.json` - Example MCP configuration
+- `/.github/workflows/` - CI/CD documentation
+- `/mcp-server/.env.example` - Environment setup
+
+## 🔐 Security Notes
+
+- JWT_SECRET must be strong and kept confidential
+- Tokens expire after 24 hours by default
+- Anonymous users have read-only access
+- Type modifications require authentication
+- All changes logged via git history
+
+## Support & Contact
+
+- Repository: https://github.com/entin-hun/tm-types
+- Issues: https://github.com/entin-hun/tm-types/issues
+- npm: https://www.npmjs.com/package/@trace.market/types (pending first publish)

package/QUICKSTART.md

@@ -0,0 +1,238 @@
+# Quick Start Guide
+
+## Setup Steps
+
+### 1. Install Dependencies
+
+```bash
+# Root package (types)
+npm install
+
+# MCP Server
+cd mcp-server
+npm install
+npm run build
+```
+
+### 2. Configure Environment
+
+```bash
+cd mcp-server
+cp .env.example .env
+# Edit .env and set a strong JWT_SECRET
+```
+
+### 3. Generate Auth Token
+
+For authenticated operations (creating/modifying types):
+
+```bash
+node mcp-server/generate-token.js yourUserId user
+```
+
+Or interactively:
+```bash
+node mcp-server/generate-token.js
+```
+
+### 4. Add to Copilot
+
+Add this to your MCP settings (in VS Code or Copilot configuration):
+
+```json
+{
+  "mcpServers": {
+    "tm-types": {
+      "command": "node",
+      "args": ["/absolute/path/to/tm-types/mcp-server/dist/index.js"],
+      "env": {
+        "JWT_SECRET": "your-secret-from-env-file"
+      }
+    }
+  }
+}
+```
+
+## Usage Examples
+
+### List All Types (No Auth Required)
+
+In Copilot:
+```
+Show me all available types in the tm-types system
+```
+
+Or direct MCP call:
+```json
+{
+  "tool": "list_types",
+  "arguments": {}
+}
+```
+
+### Get Type Definition (No Auth Required)
+
+```
+What fields does the FoodInstance type have?
+```
+
+### Validate Data (No Auth Required)
+
+```
+Check if this data is valid for FoodInstance type:
+{
+  "category": "food",
+  "bio": true,
+  "quantity": 1000
+}
+```
+
+### Create Type from Description (Auth Required)
+
+First, generate a token:
+```bash
+TOKEN=$(node mcp-server/generate-token.js myUserId user | grep "eyJ" | xargs)
+```
+
+Then in Copilot:
+```
+Create a new type called "OrganicCertification" with fields for:
+- certifier name (string)
+- certification number (string)  
+- issue date (timestamp)
+- expiry date (timestamp)
+- certification body (string)
+- certificate URL (string)
+
+Use auth token: [paste token here]
+```
+
+### Generate Report (No Auth Required)
+
+```
+Generate a summary report for this product data:
+{
+  "name": "Coconut Drink",
+  "carbon": 0.5,
+  "water": 100
+}
+```
+
+## Publishing Types to NPM
+
+### First Time Setup
+
+1. Create NPM account at https://www.npmjs.com/
+2. Generate access token: https://www.npmjs.com/settings/your-username/tokens
+3. Add token to GitHub secrets as `NPM_TOKEN`
+
+### Publishing Process
+
+The CI/CD is configured to automatically publish when:
+To switch from `@fairfooddata/types` to `@trace.market/types`:
+1. You push to main branch
+2. The version in package.json has changed
+3. TypeScript validation passes
+
+**To publish a new version:**
+npm install @trace.market/types
+```bash
+# 1. Update version
+npm version patch  # or minor, or major
+
+# 2. Push changes
+git push origin main
+
+# 3. GitHub Actions will automatically:
+#    - Validate types
+import { FoodInstance } from '@trace.market/types';
+#    - Create git tag
+#    - Create GitHub release
+```
+
+### Manual Publishing (if needed)
+```
+
+## Migrating Projects
+
+- Check npm registry: `npm view @trace.market/types`
+### 1. Update package.json
+
+```bash
+npm uninstall @fairfooddata/types
+npm install @trace.market/types
+```
+
+### 2. Update Imports
+
+```typescript
+// Old
+import { FoodInstance } from '@fairfooddata/types';
+
+// New  
+import { FoodInstance } from '@trace.market/types';
+```
+
+### 3. Run Find & Replace
+
+In VS Code:
+- Find: `@fairfooddata/types`
+- Replace: `@trace.market/types`
+- Replace in all files across workspace
+
+## Adding New Types
+
+### Method 1: Natural Language (Recommended)
+
+1. Generate auth token
+2. Use Copilot to describe the type
+3. Review generated code
+4. Add to repository using `add_type_definition` tool
+
+### Method 2: Manual Edit
+
+1. Edit `src/index.d.ts`
+2. Add your type definition
+3. Run `npm run validate` to check
+4. Commit and push
+
+### Method 3: Pull Request
+
+1. Fork repository
+2. Add type definitions
+3. Create PR
+4. Team reviews and merges
+
+## Testing MCP Server Locally
+
+```bash
+# Terminal 1: Start MCP server
+cd mcp-server
+npm start
+
+# Terminal 2: Test with stdio
+echo '{"method":"tools/list"}' | node dist/index.js
+```
+
+## Troubleshooting
+
+### "Authentication required" error
+- Generate a valid JWT token
+- Make sure JWT_SECRET matches in .env and token generation
+- Check token hasn't expired (default 24h)
+
+### Types not updating
+- Clear node_modules cache: `rm -rf node_modules package-lock.json && npm install`
+- Check npm registry: `npm view @trace.market/types`
+- Verify version number incremented
+
+### MCP server not responding
+- Check it built successfully: `ls mcp-server/dist/`
+- Verify Node.js version: `node --version` (should be 18+)
+- Check environment variables are set
+
+## Support
+
+- GitHub Issues: https://github.com/entin-hun/tm-types/issues
+- Documentation: See README files
+- Example usage: Check tm-editor, tm-marketplace projects

package/README.md

@@ -0,0 +1,144 @@
+# @trace.market/types
+
+TypeScript type definitions for the Trace Market food supply chain traceability platform.
+
+## Overview
+
+This package provides comprehensive TypeScript types for food traceability data, including:
+- **Product instances**: Food items, cartridges, and other products
+- **Process tracking**: Milling, printing, freeze-drying, blending, sales, and harvests
+- **Supply chain data**: Transport, facilities, locations, and impacts
+- **Blockchain integration**: NFT metadata and token references
+
+## Installation
+
+```bash
+npm install @trace.market/types
+```
+
+## Usage
+
+```typescript
+import {
+  FoodInstance,
+  ProductInstance,
+  Pokedex,
+  SaleProcess,
+  Impact
+} from '@trace.market/types';
+
+const product: FoodInstance = {
+  category: 'food',
+  type: 'coconut-drink',
+  bio: true,
+  quantity: 1000,
+  ownerId: 'plantsoul',
+  process: {
+    type: 'blending',
+    timestamp: Date.now(),
+    facility: {
+      label: 'PlantSoul Factory',
+      location: {
+        type: 'Point',
+        coordinates: [19.0402, 47.4979]
+      }
+    },
+    temperatureRange: { min: 4, max: 8 },
+    inputInstances: [],
+    impacts: [
+      {
+        category: 'carbon',
+        ownerId: 'plantsoul',
+        format: 'CO2e',
+        quantity: 0.5
+      }
+    ]
+  }
+};
+```
+
+## Available Types
+
+### Core Types
+- `Pokedex`: Main container for NFT metadata and product instances
+- `ProductInstance`: Union type for all product categories
+- `FoodInstance`: Food products with nutrition and process data
+- `CartridgeInstance`: Printer cartridge tracking
+
+### Process Types
+- `Process`: Union of all process types
+- `GenericProcess`: Base process interface
+- `MillingProcess`: Grain/seed processing
+- `PrintingProcess`: 3D printing operations
+- `FreezeDryingProcess`: Freeze-drying operations
+- `BlendingProcess`: Mixing ingredients
+- `SaleProcess`: Sales transactions
+- `HarvestProcess`: Agricultural harvesting
+
+### Supply Chain
+- `InputInstance`: Local or transported inputs
+- `Transport`: Transportation tracking
+- `Facility`: Processing facilities and locations
+- `Location`: GeoJSON point coordinates
+
+### Environmental Impact
+- `Impact`: Union of impact types
+- `CarbonImpact`: CO2 emissions
+- `WaterImpact`: Water usage
+
+### Supporting Types
+- `Price`: Pricing information
+- `KnowHow`: Proprietary process knowledge
+- `MachineInstance`: Equipment tracking
+- `TemperatureRange`: Storage/process temperatures
+- `FallbackFoodNutrient`: Nutrition data
+- `ID`: Registry identifiers
+
+## MCP Server
+
+This package includes an MCP (Model Context Protocol) server for intelligent type management. See [mcp-server/README.md](./mcp-server/README.md) for details.
+
+### Key Features
+- **Natural language type creation**: Describe types in plain English
+- **Automatic validation**: Check data against type definitions
+- **Custom reports**: Generate formatted reports from your data
+- **Authentication support**: Secure type management for authorized users
+- **Public API**: Anonymous access for queries and reports
+
+## Contributing
+
+This is a self-managed repository for the Trace Market team. To add or modify types:
+
+1. **For authenticated users**: Use the MCP server's `create_type_from_description` tool
+2. **Manual method**: Edit `src/index.d.ts` and submit a pull request
+3. **Automated**: CI/CD will validate and publish on merge to main
+
+### Versioning
+
+We use semantic versioning:
+- **Patch** (0.0.x): Documentation, comments, minor fixes
+- **Minor** (0.x.0): New types, backward-compatible changes
+- **Major** (x.0.0): Breaking changes to existing types
+
+Update the version in `package.json` before committing changes that should trigger a new npm release.
+
+## CI/CD
+
+- **Automatic publishing**: Pushes to main trigger npm publish if version changed
+- **Validation**: TypeScript compilation runs on all commits
+- **MCP server builds**: Automatic builds on changes to mcp-server/
+
+## Repository
+
+- **GitHub**: https://github.com/entin-hun/tm-types
+- **npm**: https://www.npmjs.com/package/@trace.market/types (coming soon)
+
+## License
+
+MIT
+
+## Related Projects
+
+- [tm-editor](../tm-editor): Visual editor for creating product instances
+- [tm-marketplace](../tm-marketplace): NFT marketplace for traced products
+- [tm-package-page](../tm-package-page%20buy): Consumer-facing product pages

package/mcp-config.example.json

@@ -0,0 +1,13 @@
+{
+  "mcpServers": {
+    "tm-types": {
+      "command": "node",
+      "args": [
+        "/Users/mac-pro/dev_projects/trace market/tm-types/mcp-server/dist/index.js"
+      ],
+      "env": {
+        "JWT_SECRET": "change-this-to-your-secret-key"
+      }
+    }
+  }
+}

package/mcp-server/.env.example

@@ -0,0 +1,9 @@
+# Environment variables for MCP server
+JWT_SECRET=your-super-secret-jwt-key-change-this-in-production
+
+# Optional: Database connection if you want to persist data
+# DATABASE_URL=postgresql://user:password@localhost:5432/tm_types
+
+# Optional: External LLM API for better natural language processing
+# OPENAI_API_KEY=sk-...
+# ANTHROPIC_API_KEY=sk-ant-...