@tangle-network/starter-foundry 0.5.4 → 0.7.0

package/registry/families/pixijs-game/manifest.json

@@ -0,0 +1,90 @@
+{
+  "id": "pixijs-game",
+  "description": "Pixi.js v8 2D starter on Vite — Application, one Container, rotating sprite, resize + ticker wired from first render. Pixi v8 API (not v7).",
+  "tags": ["frontend", "typescript", "pixi.js", "game", "2d", "webgpu"],
+  "taxonomy": {
+    "language": "typescript",
+    "runtime": "node",
+    "surface": "frontend"
+  },
+  "defaults": {
+    "projectType": "frontend",
+    "serviceName": "starter-foundry-pixi",
+    "port": 5173
+  },
+  "files": [
+    { "source": "files/package.json", "target": "package.json" },
+    { "source": "files/tsconfig.json", "target": "tsconfig.json" },
+    { "source": "files/vite.config.ts", "target": "vite.config.ts" },
+    { "source": "files/index.html", "target": "index.html" },
+    { "source": "files/validate-pixi.mjs", "target": "validate-pixi.mjs" }
+  ],
+  "validationChecks": [
+    { "type": "file-exists", "path": "index.html" },
+    { "type": "file-exists", "path": "src/main.ts" },
+    { "type": "file-exists", "path": "package.json" },
+    {
+      "type": "command-success",
+      "command": ["node", "validate-pixi.mjs"],
+      "expect": "pixi game starter ok"
+    }
+  ],
+  "contextHints": {
+    "commands": ["pnpm install", "pnpm dev", "pnpm build"],
+    "entrypoints": ["src/main.ts", "index.html", "vite.config.ts"],
+    "preview": { "path": "/" },
+    "extensionPoints": ["src/main.ts", "src/scenes", "public/assets"]
+  },
+  "keywords": [
+    "pixi",
+    "pixi.js",
+    "pixijs",
+    "2d webgl",
+    "2d webgpu",
+    "2d renderer",
+    "interactive canvas",
+    "sprite animation"
+  ],
+  "scoring": {
+    "boost": { "pixi.js": 4, "pixijs": 4, "pixi": 3 }
+  },
+  "tieredKeywords": {
+    "tier1": ["pixi.js", "pixijs", "pixi v8", "2d webgpu"],
+    "tier2": ["2d webgl renderer", "interactive canvas", "sprite animation", "data visualization canvas"],
+    "archetypes": [
+      "interactive 2d data visualization",
+      "particle system",
+      "sprite-based hud",
+      "whiteboard canvas",
+      "live generative art",
+      "2d map editor",
+      "real-time chart"
+    ]
+  },
+  "buildHints": {
+    "whenToUse": "High-performance 2D canvas work — interactive data viz, particle systems, generative art, map editors, live charts. Pick over Phaser when you want a raw renderer without scene+physics machinery.",
+    "firstSteps": [
+      "Install: `pnpm install` then `pnpm dev` — Vite serves on 5173 with HMR. A rotating gradient sprite renders immediately.",
+      "Pixi v8 uses `await app.init(...)` — it is ASYNC. Do not call `new Application()` and start rendering synchronously; sprites attached before init never appear.",
+      "Put art in `public/assets/` and load via `Assets.load('assets/foo.png')` — the v8 Assets loader replaces the v7 Loader class.",
+      "Attach children to `app.stage` (or a sub-Container). `app.ticker.add(...)` drives per-frame updates.",
+      "Build: `pnpm build` emits static assets to `dist/` — deploy on any static host."
+    ],
+    "gotchas": [
+      "Pixi v8 is a BREAKING rewrite of v7. Do NOT copy v7 tutorials — `new Application({ width, height })` is gone; use `const app = new Application(); await app.init({ width, height });`.",
+      "Pixi v8 supports both WebGL and WebGPU. Default renderer is chosen automatically — pin with `preference: 'webgpu'` if you need WebGPU explicitly.",
+      "The Ticker runs after `app.init()` only. Don't add ticker callbacks before init — they're attached to a placeholder and never fire.",
+      "On teardown (HMR, route change), call `app.destroy(true, { children: true, texture: true })` to release GPU memory. Without it, HMR leaks textures fast."
+    ],
+    "architectureNotes": [
+      "Application owns: renderer, stage (root Container), ticker. One Application per canvas.",
+      "Scene composition = Container hierarchy. Containers transform children; leaves are Sprites, Graphics, Text, Mesh."
+    ],
+    "placeholders": [
+      {
+        "path": "src/main.ts",
+        "description": "Application init + rotating sprite. Replace the placeholder content with the product's actual draw loop; keep the init + destroy plumbing."
+      }
+    ]
+  }
+}

package/registry/families/playwright-worker/files/package.json

@@ -7,5 +7,13 @@
   },
   "dependencies": {
     "playwright": "^1.54.0"
+  },
+  "overrides": {
+    "vite": "^6.4.2"
+  },
+  "pnpm": {
+    "overrides": {
+      "vite": "^6.4.2"
+    }
   }
 }

package/registry/families/polymarket-portfolio-hedging/files/.env.example

@@ -0,0 +1,5 @@
+VITE_POLYMARKET_API_KEY=placeholder-hedging-api-key
+VITE_POLYMARKET_API_SECRET=placeholder-hedging-api-secret
+VITE_PORTFOLIO_HEDGING_STRATEGY=placeholder-hedging-strategy
+VITE_RISK_MANAGEMENT_THRESHOLD=placeholder-risk-threshold
+VITE_OPTIMIZATION_INTERVAL=placeholder-optimization-interval

package/registry/families/polymarket-portfolio-hedging/files/README.md

@@ -0,0 +1,37 @@
+# polymarket-portfolio-hedging starter
+## Quickstart
+To get started with the polymarket-portfolio-hedging starter, run the following commands:
+```bash
+npm install
+npm run dev
+```
+or
+```bash
+pnpm install
+pnpm run dev
+```
+This will install the required dependencies and start the development server.
+
+## Environment
+The following environment variables are used in this project:
+* VITE_POLYMARKET_API_KEY: API key for Polymarket, obtain from Polymarket dashboard
+* VITE_POLYMARKET_API_SECRET: API secret for Polymarket, obtain from Polymarket dashboard
+* VITE_PORTFOLIO_HEDGING_STRATEGY: hedging strategy to use, e.g. "mean-variance" or "black-litterman", default is "mean-variance"
+* VITE_RISK_FREE_RATE: risk-free rate, e.g. 0.02 for 2%, default is 0.02
+* VITE_EXPECTED_RETURN: expected return, e.g. 0.08 for 8%, default is 0.08
+
+## Architecture
+The polymarket-portfolio-hedging starter consists of two main components: `src/main` and `src/App`. 
+* `src/main` contains the main application logic, including the hedging strategy and portfolio optimization.
+* `src/App` contains the frontend code, including the user interface and API calls to Polymarket.
+The project uses the following dependencies:
+* `polymarket-js`: Polymarket JavaScript library for interacting with the Polymarket API
+* `typescript`: TypeScript compiler and type checker
+* `vite`: Vite development server and build tool
+* `react`: React JavaScript library for building user interfaces
+
+## Extension Points
+The following files are likely to be edited when building on this starter:
+* `src/main/hedgingStrategy.ts`: implements the hedging strategy, e.g. mean-variance or black-litterman
+* `src/App/components/Portfolio.tsx`: displays the portfolio and allows user input for hedging strategy and risk parameters
+* `src/App/api/polymarket.ts`: contains API calls to Polymarket, e.g. for fetching market data or submitting orders

package/registry/families/polymarket-portfolio-hedging/files/index.html

@@ -0,0 +1 @@
+<!DOCTYPE html><html lang="en"><head><meta charset="UTF-8"><meta name="viewport" content="width=device-width, initial-scale=1.0"><title>Polymarket Portfolio Hedging</title></head><body><div id="root"></div><script type="module" src="/src/main.tsx"></script></body></html>

package/registry/families/polymarket-portfolio-hedging/files/package.json

@@ -0,0 +1,32 @@
+{
+  "name": "polymarket-portfolio-hedging",
+  "version": "1.0.0",
+  "type": "module",
+  "private": true,
+  "scripts": {
+    "dev": "vite",
+    "build": "tsc --noEmit && vite build",
+    "preview": "vite preview",
+    "test": "vitest run"
+  },
+  "dependencies": {
+    "react": "^18.2.0",
+    "react-dom": "^18.2.0"
+  },
+  "devDependencies": {
+    "@types/react": "^18.0.17",
+    "@types/react-dom": "^18.0.6",
+    "@vitejs/plugin-react": "^2.0.1",
+    "typescript": "^5.0.4",
+    "vite": "^3.0.0",
+    "vitest": "^0.24.4"
+  },
+  "overrides": {
+    "vite": "^5.4.10"
+  },
+  "pnpm": {
+    "overrides": {
+      "vite": "^5.4.10"
+    }
+  }
+}

package/registry/families/polymarket-portfolio-hedging/files/src/App.tsx

@@ -0,0 +1,45 @@
+import React, { useState } from 'react';
+import './App.css';
+
+function App() {
+  const [hedgingStrategies, setHedgingStrategies] = useState([
+    { id: 1, name: 'Strategy 1' },
+    { id: 2, name: 'Strategy 2' },
+  ]);
+
+  const [portfolioOptimization, setPortfolioOptimization] = useState([
+    { id: 1, name: 'Optimization 1' },
+    { id: 2, name: 'Optimization 2' },
+  ]);
+
+  const [riskManagement, setRiskManagement] = useState([
+    { id: 1, name: 'Management 1' },
+    { id: 2, name: 'Management 2' },
+  ]);
+
+  return (
+    <div className="App">
+      <h1>Polymarket Portfolio Hedging</h1>
+      <h2>Hedging Strategies:</h2>
+      <ul>
+        {hedgingStrategies.map((strategy) => (
+          <li key={strategy.id}>{strategy.name}</li>
+        ))}
+      </ul>
+      <h2>Portfolio Optimization:</h2>
+      <ul>
+        {portfolioOptimization.map((optimization) => (
+          <li key={optimization.id}>{optimization.name}</li>
+        ))}
+      </ul>
+      <h2>Risk Management:</h2>
+      <ul>
+        {riskManagement.map((management) => (
+          <li key={management.id}>{management.name}</li>
+        ))}
+      </ul>
+    </div>
+  );
+}
+
+export default App;

package/registry/families/polymarket-portfolio-hedging/files/src/main.tsx

@@ -0,0 +1,9 @@
+import React from 'react';
+import ReactDOM from 'react-dom';
+import App from './App';
+
+const rootElement = document.getElementById('root');
+if (rootElement) {
+  const root = ReactDOM.createRoot(rootElement);
+  root.render(<App />);
+}

package/registry/families/polymarket-portfolio-hedging/files/tsconfig.json

@@ -0,0 +1,12 @@
+{
+  "compilerOptions": {
+    "target": "es2022",
+    "module": "esnext",
+    "moduleResolution": "bundler",
+    "jsx": "react-jsx",
+    "strict": true,
+    "noEmit": true,
+    "skipLibCheck": true,
+    "lib": ["es2022", "dom", "dom.iterable"]
+  }
+}

package/registry/families/polymarket-portfolio-hedging/files/validate-node.mjs

@@ -0,0 +1 @@
+export { validateNode } from './validate-node.js';

package/registry/families/polymarket-portfolio-hedging/files/vite.config.ts

@@ -0,0 +1,10 @@
+import { defineConfig } from 'vite'
+import react from '@vitejs/plugin-react'
+
+// https://vitejs.dev/config/
+export default defineConfig({
+  plugins: [react()],
+  server: {
+    port: 5173
+  }
+})

package/registry/families/polymarket-portfolio-hedging/manifest.json

@@ -0,0 +1,127 @@
+{
+  "id": "polymarket-portfolio-hedging",
+  "description": "polymarket-portfolio-hedging starter — derived from 3× real demand signal (partner: polymarket-prediction). Taxonomy guess: typescript/node/frontend.",
+  "tags": [
+    "node",
+    "frontend",
+    "typescript"
+  ],
+  "taxonomy": {
+    "language": "typescript",
+    "runtime": "node",
+    "surface": "frontend"
+  },
+  "defaults": {
+    "projectType": "frontend",
+    "serviceName": "starter-foundry-polymarket-portfolio-hedging"
+  },
+  "files": [
+    {
+      "source": "files/package.json",
+      "target": "package.json"
+    },
+    {
+      "source": "files/tsconfig.json",
+      "target": "tsconfig.json"
+    },
+    {
+      "source": "files/vite.config.ts",
+      "target": "vite.config.ts"
+    },
+    {
+      "source": "files/index.html",
+      "target": "index.html"
+    },
+    {
+      "source": "files/src/main.tsx",
+      "target": "src/main.tsx"
+    },
+    {
+      "source": "files/src/App.tsx",
+      "target": "src/App.tsx"
+    },
+    {
+      "source": "files/.env.example",
+      "target": ".env.example"
+    },
+    {
+      "source": "files/README.md",
+      "target": "README.md"
+    },
+    {
+      "source": "files/validate-node.mjs",
+      "target": "validate-node.mjs"
+    }
+  ],
+  "validationChecks": [
+    {
+      "type": "file-exists",
+      "path": "package.json"
+    },
+    {
+      "type": "file-exists",
+      "path": "tsconfig.json"
+    },
+    {
+      "type": "file-exists",
+      "path": "vite.config.ts"
+    }
+  ],
+  "contextHints": {
+    "commands": [
+      "Install dependencies with npm or yarn",
+      "Import necessary modules and components",
+      "Configure hedging strategies and portfolio optimization"
+    ],
+    "entrypoints": [
+      "index.ts"
+    ],
+    "preview": null,
+    "extensionPoints": []
+  },
+  "keywords": [
+    "hedging strategies",
+    "portfolio optimization",
+    "risk management",
+    "financial modeling",
+    "market analysis",
+    "investment planning"
+  ],
+  "tieredKeywords": {
+    "tier1": [
+      "polymarket",
+      "prediction market hedging",
+      "portfolio hedging",
+      "event contract portfolio"
+    ],
+    "tier2": [
+      "financial modeling",
+      "market analysis",
+      "investment planning"
+    ]
+  },
+  "buildHints": {
+    "whenToUse": "When building a polymarket portfolio hedging application, use this starter to leverage real user demand and domain-specific functionality.",
+    "firstSteps": [
+      "Install dependencies with npm or yarn",
+      "Import necessary modules and components",
+      "Configure hedging strategies and portfolio optimization"
+    ],
+    "gotchas": [
+      "Ensure proper risk management and compliance with financial regulations",
+      "Be aware of potential market volatility and its impact on hedging strategies",
+      "Monitor and adjust portfolio optimization regularly"
+    ],
+    "architectureNotes": [
+      "Modular design with separate components for hedging strategies and portfolio optimization",
+      "Utilize TypeScript for robust type checking and Node for runtime environment",
+      "Leverage frontend capabilities for user interface and experience"
+    ],
+    "placeholders": [
+      {
+        "path": "index.ts",
+        "description": "Primary entrypoint agents must extend."
+      }
+    ]
+  }
+}

package/registry/families/python-api/manifest.json

@@ -111,9 +111,7 @@
     "api in python"
   ],
   "scoring": {
-    "boost": {
-      "python": 2
-    }
+    "boost": {}
   },
   "tieredKeywords": {
     "tier1": [

package/registry/families/rag-pipeline-py/files/.env.example

@@ -0,0 +1,20 @@
+# LLM endpoint used for answer synthesis. Defaults to a local Ollama install.
+# Any OpenAI-compatible /api/chat or /v1/chat/completions server works —
+# vLLM, TGI, llama.cpp server, LiteLLM, OpenAI itself, etc.
+LLM_BASE_URL={{llmBaseUrl}}
+LLM_MODEL={{llmModel}}
+
+# Embedding model loaded locally via sentence-transformers.
+# Changing this invalidates the Chroma collection — delete VECTOR_DB_DIR.
+EMBEDDING_MODEL={{embeddingModel}}
+
+# On-disk Chroma collection.
+VECTOR_DB_DIR={{vectorDbDir}}
+
+# Retrieval parameters.
+CHUNK_SIZE=800
+CHUNK_OVERLAP=120
+TOP_K=4
+
+# Source corpus directory.
+DOCS_DIR=./docs

package/registry/families/rag-pipeline-py/files/README-rag.md

@@ -0,0 +1,57 @@
+# RAG pipeline — operator guide
+
+End-to-end retrieval-augmented generation:
+
+```
+docs/*.md,.txt,.pdf
+        │
+        ▼
+  chunk (800/120)
+        │
+        ▼
+  sentence-transformers  ──►  Chroma (./chroma_db)
+                                    │
+                  query ────────────┤
+                                    ▼
+                           top-K retrieval
+                                    │
+                                    ▼
+                             LLM synth (Ollama/vLLM)
+```
+
+## First-run
+
+```bash
+pip install -e .
+cp .env.example .env
+# Ensure Ollama is running + pulled:
+ollama serve &
+ollama pull llama3.1:8b
+
+python -m src.pipeline index       # build the Chroma collection
+python -m src.pipeline ask "what is paged attention?"
+```
+
+## Swapping components
+
+- **Embedder**: change `EMBEDDING_MODEL` and delete `VECTOR_DB_DIR`. Popular
+  choices: `BAAI/bge-small-en-v1.5` (better quality), `intfloat/e5-large-v2`
+  (multilingual), `sentence-transformers/all-mpnet-base-v2` (bigger).
+- **LLM**: point `LLM_BASE_URL` at any OpenAI-compatible endpoint — vLLM,
+  TGI, LiteLLM, OpenAI, an internal gateway. `LLM_MODEL` is the id the
+  endpoint accepts.
+- **Vector DB**: the pipeline uses Chroma's `PersistentClient`. Swap to
+  Qdrant / Weaviate / pgvector by replacing the `Chroma` usage in
+  `src/pipeline.py`.
+
+## Production notes
+
+- **Rebuild on deploy**. Don't commit large Chroma directories — they go
+  stale when docs change and inflate git.
+- **Chunking matters more than the LLM**. Retrieval quality ceilings
+  answer quality. Tune `CHUNK_SIZE` and `CHUNK_OVERLAP` per corpus shape.
+- **Citations**: the default prompt requests `[doc:filename]` markers.
+  Verify them in the response — hallucinated citations are a common LLM
+  failure mode in RAG.
+- **Batch the embedder** for large corpora (`SentenceTransformer.encode(..., batch_size=64)`).
+  The default loop embeds one chunk at a time.

package/registry/families/rag-pipeline-py/files/docs/sample.md

@@ -0,0 +1,14 @@
+# Sample RAG corpus
+
+Replace this file with your real documents. The pipeline ingests every `.md`,
+`.txt`, and (with the `pdf` extra) `.pdf` file in this directory, chunks each
+into overlapping windows, embeds every chunk, and stores the vectors in
+Chroma. When you ask a question, the pipeline retrieves the top-K most
+similar chunks by cosine similarity and feeds them to the LLM as grounded
+context with a citation hint.
+
+PagedAttention (used by vLLM) allocates KV cache in fixed-size pages instead
+of one contiguous tensor per sequence. This lets the server pack many
+concurrent requests into a single GPU — near-zero fragmentation, high batch
+fill ratios, and throughput that scales with concurrency rather than
+flatlining at batch size 1.

package/registry/families/rag-pipeline-py/files/pyproject.toml

@@ -0,0 +1,26 @@
+[project]
+name = "{{serviceName}}"
+version = "0.1.0"
+description = "Local RAG pipeline — Chroma + sentence-transformers + local LLM"
+requires-python = ">=3.10"
+dependencies = [
+  "langchain-core>=0.3.0",
+  "langchain-community>=0.3.0",
+  "langchain-text-splitters>=0.3.0",
+  "chromadb>=0.5.0",
+  "sentence-transformers>=3.0.0",
+  "httpx>=0.27.0",
+  "pydantic>=2.9.0",
+  "python-dotenv>=1.0.0",
+]
+
+[project.optional-dependencies]
+pdf = ["pypdf>=5.0.0"]
+
+[build-system]
+requires = ["setuptools>=69", "wheel"]
+build-backend = "setuptools.build_meta"
+
+[tool.setuptools.packages.find]
+where = ["."]
+include = ["src*"]

package/registry/families/rag-pipeline-py/files/validate-rag.mjs

@@ -0,0 +1,38 @@
+import fs from "node:fs/promises";
+
+const [pyproject, pipeline, envExample, sampleDoc] = await Promise.all([
+  fs.readFile("pyproject.toml", "utf8"),
+  fs.readFile("src/pipeline.py", "utf8"),
+  fs.readFile(".env.example", "utf8"),
+  fs.readFile("docs/sample.md", "utf8"),
+]);
+
+for (const dep of ["langchain-core", "langchain-community", "chromadb", "sentence-transformers", "httpx"]) {
+  if (!pyproject.includes(dep)) {
+    throw new Error(`pyproject.toml missing ${dep}`);
+  }
+}
+
+for (const token of ["chromadb", "SentenceTransformer", "def index", "def ask", "LLM_BASE_URL"]) {
+  if (!pipeline.includes(token)) {
+    throw new Error(`src/pipeline.py missing ${token}`);
+  }
+}
+if (!pipeline.includes("RecursiveCharacterTextSplitter") && !pipeline.includes("CharacterTextSplitter")) {
+  throw new Error("src/pipeline.py missing a langchain text splitter");
+}
+if (!pipeline.includes("cosine") && !pipeline.includes("similarity_search")) {
+  throw new Error("src/pipeline.py must perform similarity search against Chroma");
+}
+
+for (const key of ["LLM_BASE_URL", "LLM_MODEL", "EMBEDDING_MODEL", "VECTOR_DB_DIR"]) {
+  if (!envExample.includes(key)) {
+    throw new Error(`.env.example missing ${key}`);
+  }
+}
+
+if (sampleDoc.trim().length < 20) {
+  throw new Error("docs/sample.md must contain real placeholder content");
+}
+
+console.log("rag pipeline starter ok");