diff --git a/.env.example b/.env.example index b8e8d48..c22449f 100644 --- a/.env.example +++ b/.env.example @@ -4,32 +4,49 @@ NODE_ENV=development CORS_ORIGIN=http://localhost:5173 # Database (Neon Postgres) -DATABASE_URL=postgresql://user:password@hostname/dbname?sslmode=require +DATABASE_URL=postgresql://user:password@hostname/dbname?sslmode=require&channel_binding=require -# Authentication (Neon Auth / Better Auth) -# Used to sign sessions. Generate one via: openssl rand -base64 32 -BETTER_AUTH_SECRET=your_better_auth_secret_here -# The base URL of your API (needed by Better Auth) +# ── Better Auth (self-hosted, data in Neon Postgres) ─────────────── +# See docs/decisions/001-authentication-strategy.md for rationale. +# Generate a fresh 32-byte secret with: +# node -e "console.log(require('crypto').randomBytes(32).toString('base64'))" +# or: openssl rand -base64 32 +BETTER_AUTH_SECRET=replace_with_32_byte_base64_secret BETTER_AUTH_URL=http://localhost:3000 -# Local catalog-only development can bypass auth when no DATABASE_URL is set. -# Production always fails closed if auth/database is unavailable. +# Local catalog-only dev may bypass auth when no DATABASE_URL is set. +# Production MUST set this to "false" so auth failures fail closed. ALLOW_AUTH_BYPASS=true -# GitHub OAuth (configured in Neon Console for production) +# GitHub OAuth (github.com/settings/developers → New OAuth App) +# Callback URL to register: +# http://localhost:3000/api/auth/callback/github (local) +# https:///api/auth/callback/github (production) GITHUB_CLIENT_ID=your_github_client_id GITHUB_CLIENT_SECRET=your_github_client_secret -# Admin API Key (For protecting /admin and /internal routes) +# Admin API Key (protects /admin and /internal routes) ADMIN_API_KEY=your_admin_api_key_here -# AI Provider (controls which LLM powers blueprint explanations) -# Options: gemini | openai | heuristic (heuristic = no API key needed) -AI_PROVIDER=gemini -AI_MODEL=gemini-2.0-flash # Optional: override the default model -AI_MAX_TOKENS=2048 # Max tokens per AI response -AI_TIMEOUT_MS=30000 # Timeout in ms before falling back to heuristic +# ── AI Provider (controls which LLM powers blueprint explanations) ─ +# Supported in packages/ai today: heuristic | gemini | azure-openai +AI_PROVIDER=heuristic +# Generic tuning (applies to whichever provider is active) +AI_MAX_TOKENS=2048 +AI_TIMEOUT_MS=30000 -# API Keys — only the key for your chosen AI_PROVIDER is required +# Gemini (Google Generative AI) — used when AI_PROVIDER=gemini GEMINI_API_KEY=your_gemini_api_key -OPENAI_API_KEY=sk-your_openai_api_key -ANTHROPIC_API_KEY=sk-ant-your_anthropic_api_key +# Optional model override for Gemini. Defaults to gemini-2.5-flash. +AI_MODEL=gemini-2.5-flash + +# Azure OpenAI — used when AI_PROVIDER=azure-openai +# Create a deployment in Azure AI Foundry (gpt-5.5 or gpt-4.1, for example), +# then set the resource sub-domain and deployment name below. +AZURE_OPENAI_RESOURCE_NAME=your_resource_name +AZURE_OPENAI_API_KEY=your_azure_openai_api_key +AZURE_OPENAI_DEPLOYMENT=gpt-5.5 +# Optional API version pin. Leave unset to use the SDK default. +AZURE_OPENAI_API_VERSION= +# Legacy OpenAI key is unused for Stackfast's Azure-only setup but +# is kept for operators who swap in the standard OpenAI endpoint. +OPENAI_API_KEY= diff --git a/.github/workflows/ci.yml b/.github/workflows/ci.yml index edf820e..c0cb5eb 100644 --- a/.github/workflows/ci.yml +++ b/.github/workflows/ci.yml @@ -24,14 +24,15 @@ jobs: version: 9 - name: Get pnpm store directory + id: pnpm-store shell: bash run: | - echo "STORE_PATH=$(pnpm store path --silent)" >> $GITHUB_ENV + echo "path=$(pnpm store path --silent)" >> $GITHUB_OUTPUT - name: Setup pnpm cache uses: actions/cache@v4 with: - path: ${{ env.STORE_PATH }} + path: ${{ steps.pnpm-store.outputs.path }} key: ${{ runner.os }}-pnpm-store-${{ hashFiles('**/pnpm-lock.yaml') }} restore-keys: | ${{ runner.os }}-pnpm-store- @@ -53,3 +54,9 @@ jobs: - name: Validate Registry run: pnpm validate:registry + + - name: Install Playwright browsers + run: pnpm exec playwright install --with-deps chromium + + - name: E2E Tests + run: pnpm test:e2e diff --git a/.gitignore b/.gitignore index 90f5633..7efd0a6 100644 --- a/.gitignore +++ b/.gitignore @@ -74,10 +74,8 @@ web_modules/ # dotenv environment variables file .env -.env.test -.env.production -.env.local -.env.*.local +.env.* +!.env.example # parcel-bundler cache (https://parceljs.org/) .cache @@ -138,4 +136,6 @@ Thumbs.db # Project specific server/public/ vite.config.ts.* -.local/ \ No newline at end of file +.local/ +test-results/ +playwright-report/ \ No newline at end of file diff --git a/Branches/StackFast-101 b/Branches/StackFast-101 deleted file mode 160000 index a2ff20f..0000000 --- a/Branches/StackFast-101 +++ /dev/null @@ -1 +0,0 @@ -Subproject commit a2ff20f867f199a88545a51aa5142897e36885ac diff --git a/Branches/StackWiseAI/StackWiseAI b/Branches/StackWiseAI/StackWiseAI deleted file mode 160000 index 529cf63..0000000 --- a/Branches/StackWiseAI/StackWiseAI +++ /dev/null @@ -1 +0,0 @@ -Subproject commit 529cf630ecb9ae372194172f385ac095a498ba70 diff --git a/Branches/StackfastPro b/Branches/StackfastPro deleted file mode 160000 index 92046af..0000000 --- a/Branches/StackfastPro +++ /dev/null @@ -1 +0,0 @@ -Subproject commit 92046af02f0cb29df6b931d91929a64ccf5254b8 diff --git a/Dockerfile b/Dockerfile deleted file mode 100644 index 8a75e1b..0000000 --- a/Dockerfile +++ /dev/null @@ -1,21 +0,0 @@ -# Build and run the server in production -FROM node:20-alpine AS deps -WORKDIR /app -COPY package*.json ./ -RUN npm ci - -FROM node:20-alpine AS builder -WORKDIR /app -COPY --from=deps /app/node_modules ./node_modules -COPY . . -RUN npm run build - -FROM node:20-alpine AS runner -WORKDIR /app -ENV NODE_ENV=production PORT=5000 -COPY --from=builder /app/dist ./dist -COPY package*.json ./ -RUN npm i --omit=dev --no-audit --no-fund -EXPOSE 5000 -CMD ["node","dist/index.js"] - diff --git a/ROADMAP.md b/ROADMAP.md index cf6eed6..91b1e02 100644 --- a/ROADMAP.md +++ b/ROADMAP.md @@ -27,13 +27,14 @@ Secure existing work and remove dead weight before building anything new. ### Deliverables - [x] Archive branch `archive/pre-rebuild` created - [x] Salvage manifest finalized (SALVAGE_MANIFEST.md) -- [ ] Old branches deleted (StackFastold, StackFast1) -- [ ] developer-tools-api deleted -- [ ] Stale docs deleted (5 files) +- [x] Old branches deleted (StackFastold, StackFast1, StackfastPro, StackFast-101, StackWiseAI) +- [x] developer-tools-api deleted +- [x] Stale docs deleted (5 files) — 3 actual deletions + 2 moved to `docs/backlog/` and `docs/deferred/` - [x] `.env` files removed from source - [x] `desktop.ini` files removed recursively - [x] `.gitignore` updated with comprehensive exclusions -- [ ] Clean commit: "Phase 0: Repository cleanup for 2026 rebuild" +- [x] Post-extraction cleanup complete (root `client/`, `server/`, `shared/`, `Branches/`, `Referencedocs/`, legacy build configs, logs, debris) +- [x] Clean commit: "Phase 0: Repository cleanup for 2026 rebuild" ### Risk **Low.** Archive branch preserves everything. Reversible. @@ -154,7 +155,7 @@ Ship a polished frontend that makes the API accessible and delightful. Make the blueprint generator actually valuable with LLM-powered explanations. ### Deliverables -- [ ] `packages/ai/` — Provider abstraction (OpenAI/Gemini/Anthropic) +- [x] `packages/ai/` — Provider abstraction (heuristic, Gemini, Azure OpenAI) - [x] Deterministic rules remain source of truth for scoring - [x] LLM adds explanation and synthesis layer - [x] Every AI response validated with Zod @@ -166,7 +167,13 @@ Make the blueprint generator actually valuable with LLM-powered explanations. - [x] Fallback to deterministic-only mode if AI unavailable ### Current Status -**Started/in progress.** Gemini-backed explanation and deterministic fallback paths exist, but the provider abstraction is incomplete and OpenAI/Anthropic support remains stubbed or not implemented. +**Phase 5 scope is complete for MVP.** `heuristic`, `gemini`, and +`azure-openai` providers ship in `packages/ai`. The operator's Azure AI +Foundry resource (with `gpt-5.5` / `gpt-4.1` deployments) is the primary +production provider; Gemini remains available as a lower-cost fallback. +Every AI call is wrapped in a heuristic fallback and validated with Zod. +See `docs/decisions/002-ai-provider-strategy.md`. The one remaining item +(ADR generation in the blueprint response itself) is deferred to v1.1. ### Risk **Medium.** LLM integration introduces latency and cost. Provider API changes can break things. Zod validation of AI output needs thorough testing. @@ -223,13 +230,13 @@ Build a registry that's genuinely useful for 2026 technology decisions. - [x] Zero type errors across all packages - [x] All unit tests pass (rules, scoring, registry, exporter, schemas) - [x] API contract tests for every public endpoint -- [ ] Playwright E2E tests for primary flows +- [x] Playwright E2E tests for primary flows - [x] Security tests for admin routes and rate limiting - [x] CI pipeline blocks merge on any failure - [x] Small seed dataset for database-free local dev ### Current Status -**Basic quality gate is green.** Lint, type-check, unit tests, builds, registry validation, API contract coverage, admin protection checks, and rate-limit tests pass. E2E and deeper security testing remain open. +**Quality gate is green for the MVP codebase.** Type-check, lint, unit/API tests, builds, registry validation, API contract coverage, admin protection checks, rate-limit tests, and Playwright E2E MVP flows pass locally. Remaining security/deployment hardening belongs to Phase 8. --- @@ -254,14 +261,14 @@ Build a registry that's genuinely useful for 2026 technology decisions. | Feature | Status | Priority | |---------|--------|----------| -| Idea-to-stack blueprint | 🔲 | P0 | -| Compatibility-scored stack options | 🔲 | P0 | -| Tool search and details | 🔲 | P0 | -| Stack builder with diagnostics | 🔲 | P0 | -| Starter file export | 🔲 | P0 | -| Alternatives and tradeoffs | 🔲 | P0 | -| GitHub OAuth login | 🔲 | P0 | -| Migration path (basic) | 🔲 | P1 | +| Idea-to-stack blueprint | ✅ | P0 | +| Compatibility-scored stack options | ✅ | P0 | +| Tool search and details | ✅ | P0 | +| Stack builder with diagnostics | ✅ | P0 | +| Starter file export | ✅ | P0 | +| Alternatives and tradeoffs | ✅ | P0 | +| GitHub OAuth login | ⚠️ Configured, production verification pending | P0 | +| Migration path (basic) | ✅ | P1 | ### NOT in MVP diff --git a/Referencedocs/README_CI_DOCKER.md b/Referencedocs/README_CI_DOCKER.md deleted file mode 100644 index f9dfc6d..0000000 --- a/Referencedocs/README_CI_DOCKER.md +++ /dev/null @@ -1,54 +0,0 @@ -# CI, Docker, and Environment Setup - -## Environment - -- Create `.env` at repo root: -``` -PORT=5000 -DATABASE_URL=postgres://user:pass@host/db -NODE_ENV=development -``` - -## Local Development - -- Install deps: `npm install` -- Dev server (mem storage when no DB): `npm run dev` -- Build client+server: `npm run build` -- Start production server: `npm start` - -## Docker - -Create `Dockerfile` and `docker-compose.yml` if needed. Example: - -Dockerfile -``` -FROM node:20-alpine -WORKDIR /app -COPY package*.json ./ -RUN npm ci -COPY . . -RUN npm run build -ENV NODE_ENV=production PORT=5000 -EXPOSE 5000 -CMD ["node","dist/index.js"] -``` - -## GitHub Actions (CI) - -Add `.github/workflows/ci.yml`: -``` -name: CI -on: [push, pull_request] -jobs: - build: - runs-on: ubuntu-latest - steps: - - uses: actions/checkout@v4 - - uses: actions/setup-node@v4 - with: - node-version: 20 - - run: npm ci - - run: npm run check - - run: npm run build -``` - diff --git a/SALVAGE_MANIFEST.md b/SALVAGE_MANIFEST.md index 9ea797e..5f70d20 100644 --- a/SALVAGE_MANIFEST.md +++ b/SALVAGE_MANIFEST.md @@ -126,6 +126,48 @@ ## Post-Extraction Cleanup +Completed on 2026-05-11. The following were removed from the main working tree +(all preserved on `origin/archive/pre-rebuild` if ever needed): + +1. Root `client/` (old React app — 104 files) +2. Root `server/` (old Express/Drizzle server — 19 files) +3. Root `shared/schema.ts` (migrated to `packages/schemas/src/db.ts`) +4. `Branches/StackFast-101/`, `Branches/StackfastPro/` (orphan submodule + gitlinks — no `.gitmodules` ever existed, so git couldn't hydrate them) +5. `Branches/StackWiseAI/` (inspiration-only, concepts already documented) +6. `WebAILyzerAPI/` (orphan submodule gitlink; SHA preserved in + `docs/deferred/webailyzer.md` for post-MVP revival) +7. `Referencedocs/` — `INTEGRATION_PLAN.md` moved to `docs/backlog/`, + `README_CI_DOCKER.md` dropped (superseded by current CI workflow) +8. Root build configs: `vite.config.ts`, `tailwind.config.ts`, `tsconfig.json`, + `postcss.config.js`, `drizzle.config.ts`, `components.json` (each app now + owns its own config) +9. Root `Dockerfile` (npm-based, port 5000 — will be rewritten for monorepo + deployment in Phase 8) +10. Root `package-lock.json` (monorepo uses `pnpm-lock.yaml`) +11. `attached_assets/` (legacy screenshots and docs — 23 files, 5.8MB) +12. `fix-scores.js`, `export.csv`, `dev.log`, `run.log` (stale debris) + +The repository now contains only: +``` +stackfast/ +├── apps/web/ +├── apps/api/ +├── packages/{registry,rules-engine,schemas,exporter,ai,shared}/ +├── docs/{decisions,backlog,deferred}/ +├── tests/e2e/ +├── scripts/ +├── .github/workflows/ +├── pnpm-workspace.yaml +├── tsconfig.base.json +├── .env.example +├── .gitignore +├── Agents.md +├── readme.md +├── ROADMAP.md +└── SALVAGE_MANIFEST.md +``` + After all files are extracted to their new locations: 1. Delete `Branches/StackFast-101/` (no longer needed as reference) diff --git a/WebAILyzerAPI b/WebAILyzerAPI deleted file mode 160000 index c4b2b84..0000000 --- a/WebAILyzerAPI +++ /dev/null @@ -1 +0,0 @@ -Subproject commit c4b2b84db86ad4e528ba27fe476f39754f4513d6 diff --git a/apps/api/package.json b/apps/api/package.json index 4680089..5fc2493 100644 --- a/apps/api/package.json +++ b/apps/api/package.json @@ -4,31 +4,31 @@ "private": true, "type": "module", "scripts": { - "dev": "tsx watch src/index.ts", + "dev": "dotenv -e ../../.env -- tsx watch src/index.ts", "build": "tsc", - "start": "node dist/index.js", + "start": "dotenv -e ../../.env -- node dist/index.js", "lint": "eslint src/", "type-check": "tsc --noEmit", - "test": "vitest run --config ../../vitest.package.config.ts", - "seed": "tsx src/db/seed.ts" + "test": "vitest run", + "seed": "dotenv -e ../../.env -- tsx src/db/seed.ts" }, "dependencies": { - "@stackfast/shared": "workspace:*", - "@stackfast/schemas": "workspace:*", + "@hono/node-server": "^1.13.7", + "@neondatabase/serverless": "^0.10.4", + "@stackfast/ai": "workspace:*", + "@stackfast/exporter": "workspace:*", "@stackfast/registry": "workspace:*", "@stackfast/rules-engine": "workspace:*", - "@stackfast/exporter": "workspace:*", - "@stackfast/ai": "workspace:*", - "hono": "^4.6.1", - "@hono/node-server": "^1.13.7", + "@stackfast/schemas": "workspace:*", + "@stackfast/shared": "workspace:*", "better-auth": "^1.1.13", - "zod": "^3.24.2", "drizzle-orm": "^0.45.2", - "@neondatabase/serverless": "^0.10.4" + "hono": "^4.6.1", + "zod": "^3.24.2" }, "devDependencies": { - "typescript": "^5.6.3", + "@types/node": "^22.10.2", "tsx": "^4.19.2", - "@types/node": "^22.10.2" + "typescript": "^5.6.3" } } diff --git a/apps/api/src/app.test.ts b/apps/api/src/app.test.ts index 988df02..eaa1973 100644 --- a/apps/api/src/app.test.ts +++ b/apps/api/src/app.test.ts @@ -357,8 +357,9 @@ describe("api", () => { const body = await response.json(); expect(response.status).toBe(200); - expect(body.difficulty).toBe("high"); - expect(body.caveats.length).toBeGreaterThan(0); + expect(body.complexity).toBe("high"); + expect(body.estimatedTime).toBe("1-2 weeks"); + expect(body.steps).toContain("Schedule a manual architecture review for this cross-category migration"); }); it("handles same-category migration", async () => { @@ -366,8 +367,9 @@ describe("api", () => { const body = await response.json(); expect(response.status).toBe(200); - expect(body.difficulty).toBe("moderate"); - expect(body.caveats).toEqual([]); + expect(body.complexity).toBe("medium"); + expect(body.estimatedTime).toBe("1-3 days"); + expect(body.steps).not.toContain("Review cross-category architecture impact before replacing database with database."); }); // Blueprint response shape validation @@ -385,6 +387,28 @@ describe("api", () => { expect(body.recommendedStack.rationale.length).toBeGreaterThan(0); }); + it("blueprint response includes a populated roadmap", async () => { + const response = await app.request("/api/v1/blueprints", { + method: "POST", + headers: { "Content-Type": "application/json", "x-forwarded-for": "roadmap-test" }, + body: JSON.stringify({ idea: "a subscription dashboard with auth and email" }), + }); + const body = await response.json(); + + expect(response.status).toBe(200); + expect(body.roadmap).toBeDefined(); + expect(Array.isArray(body.roadmap.phases)).toBe(true); + expect(body.roadmap.phases.length).toBeGreaterThanOrEqual(2); + expect(body.roadmap.phases.length).toBeLessThanOrEqual(5); + expect(typeof body.roadmap.totalEstimate).toBe("string"); + for (const phase of body.roadmap.phases) { + expect(typeof phase.name).toBe("string"); + expect(typeof phase.duration).toBe("string"); + expect(Array.isArray(phase.tasks)).toBe(true); + expect(phase.tasks.length).toBeGreaterThan(0); + } + }); + it("blueprint alternatives include tradeoff source", async () => { const response = await app.request("/api/v1/blueprints", { method: "POST", @@ -400,6 +424,27 @@ describe("api", () => { } }); + it("blueprint alternatives include whyNot explanations", async () => { + const response = await app.request("/api/v1/blueprints", { + method: "POST", + headers: { "Content-Type": "application/json", "x-forwarded-for": "whynot-test" }, + body: JSON.stringify({ idea: "a blog with user accounts" }), + }); + const body = await response.json(); + + expect(response.status).toBe(200); + expect(body.alternatives.length).toBeGreaterThan(0); + for (const alt of body.alternatives) { + expect(alt.whyNot).toBeDefined(); + expect(typeof alt.whyNot.reason).toBe("string"); + expect(alt.whyNot.reason.length).toBeGreaterThan(0); + // betterFor is optional but should be a string when present + if (alt.whyNot.betterFor !== undefined) { + expect(typeof alt.whyNot.betterFor).toBe("string"); + } + } + }); + // Request ID header it("returns X-Request-ID header on all responses", async () => { const response = await app.request("/health"); diff --git a/apps/api/src/app.ts b/apps/api/src/app.ts index 2b6d488..bf97c24 100644 --- a/apps/api/src/app.ts +++ b/apps/api/src/app.ts @@ -61,14 +61,19 @@ const catalogLoader = new CatalogLoader(); const configuredCorsOrigin = process.env.CORS_ORIGIN ?? process.env.WEB_ORIGIN ?? "http://localhost:5173"; // Initialize AI explainer from env config (defaults to heuristic if no key) -const aiProvider = (process.env.AI_PROVIDER ?? "heuristic") as "gemini" | "openai" | "heuristic"; +const aiProvider = (process.env.AI_PROVIDER ?? "heuristic") as "gemini" | "azure-openai" | "heuristic"; const explainer = createExplainer({ provider: aiProvider, apiKey: aiProvider === "gemini" ? process.env.GEMINI_API_KEY : - aiProvider === "openai" ? process.env.OPENAI_API_KEY : + aiProvider === "azure-openai" ? process.env.AZURE_OPENAI_API_KEY : undefined, - model: process.env.AI_MODEL || undefined, + model: + aiProvider === "azure-openai" + ? process.env.AZURE_OPENAI_DEPLOYMENT || process.env.AI_MODEL || undefined + : process.env.AI_MODEL || undefined, + azureResourceName: process.env.AZURE_OPENAI_RESOURCE_NAME, + azureApiVersion: process.env.AZURE_OPENAI_API_VERSION, maxTokens: process.env.AI_MAX_TOKENS ? Number(process.env.AI_MAX_TOKENS) : undefined, timeoutMs: process.env.AI_TIMEOUT_MS ? Number(process.env.AI_TIMEOUT_MS) : undefined, }); @@ -130,8 +135,13 @@ app.post("/api/v1/blueprints", async (c) => { const primaryEvaluation = evaluateRulesSync(primaryTools, catalogLoader.getRules()); const primaryExport = await generateSafeExport(primaryTools, primaryEvaluation.diagnostics, "blueprint-app"); - // AI explainer — uses configured provider with automatic heuristic fallback - const explanation = await explainer.explainStack(primaryTools, body.idea); + // AI explainer — uses configured provider with automatic heuristic fallback. + // explainStack, generateRoadmap, per-alternative tradeoffs and whyNot are + // all issued in parallel so a blueprint request does not fan out serially. + const [explanation, roadmapResult] = await Promise.all([ + explainer.explainStack(primaryTools, body.idea), + explainer.generateRoadmap(primaryTools, body.idea), + ]); // Static cost estimation from registry pricing data const costEstimate = estimateCosts(primaryTools); @@ -140,7 +150,10 @@ app.post("/api/v1/blueprints", async (c) => { buildAlternatives(primaryToolIds).map(async (toolIds) => { const tools = resolveTools(toolIds); const evaluation = evaluateRulesSync(tools, catalogLoader.getRules()); - const tradeoffResult = await explainer.summarizeTradeoffs(tools, evaluation.diagnostics); + const [tradeoffResult, whyNotResult] = await Promise.all([ + explainer.summarizeTradeoffs(tools, evaluation.diagnostics), + explainer.explainWhyNot(primaryTools, tools, body.idea), + ]); return { id: toolIds.join("-"), name: tools.map((tool) => tool.name).join(" + "), @@ -148,6 +161,7 @@ app.post("/api/v1/blueprints", async (c) => { harmonyScore: evaluation.score, tradeoffs: tradeoffResult.tradeoffs, tradeoffSource: tradeoffResult.source, + whyNot: whyNotResult.whyNot, }; }), ); @@ -169,6 +183,7 @@ app.post("/api/v1/blueprints", async (c) => { .filter((diagnostic) => diagnostic.level === "error" || diagnostic.level === "warning") .map((diagnostic) => diagnostic.message), costEstimate, + roadmap: roadmapResult.roadmap, files: primaryExport.files, export: primaryExport, }); @@ -277,14 +292,15 @@ app.get("/api/v1/migrations/:from/:to", (c) => { return c.json({ from: from.id, to: to.id, - difficulty: from.categoryId === to.categoryId ? "moderate" : "high", + complexity: from.categoryId === to.categoryId ? "medium" : "high", + estimatedTime: from.categoryId === to.categoryId ? "1-3 days" : "1-2 weeks", steps: [ `Inventory current ${from.name} usage and configuration`, `Create equivalent ${to.name} configuration in a branch`, "Migrate environment variables and secrets", "Run compatibility tests and deploy behind a rollback plan", + ...(from.categoryId === to.categoryId ? [] : ["Schedule a manual architecture review for this cross-category migration"]), ], - caveats: from.categoryId === to.categoryId ? [] : ["Cross-category migrations require manual architecture review"], }); }); diff --git a/apps/api/src/db/seed.ts b/apps/api/src/db/seed.ts index 228edd7..14dc919 100644 --- a/apps/api/src/db/seed.ts +++ b/apps/api/src/db/seed.ts @@ -48,6 +48,12 @@ async function seed() { const url = tool.homepageUrl ?? tool.docsUrl ?? null; const pricing = tool.pricing?.model ?? "free"; const notes = tool.deprecated ? "DEPRECATED" : null; + // jsonb columns require serialized JSON — @neondatabase/serverless otherwise + // sends JS arrays as postgres array literals (e.g. {"nextjs"}). + const frameworks = JSON.stringify(tool.supports.frameworks ?? []); + const languages = JSON.stringify(tool.languages ?? []); + const capabilities = JSON.stringify(tool.capabilities ?? []); + const integrations = JSON.stringify(tool.integrations ?? []); await sql` INSERT INTO tools ( @@ -57,7 +63,7 @@ async function seed() { setup_complexity, cost_tier ) VALUES ( ${tool.id}, ${tool.name}, ${tool.description}, ${tool.categoryId}, ${url}, - ${tool.supports.frameworks ?? []}, ${tool.languages}, ${tool.capabilities}, ${tool.integrations}, + ${frameworks}::jsonb, ${languages}::jsonb, ${capabilities}::jsonb, ${integrations}::jsonb, ${tool.confidence}, ${tool.confidence}, ${pricing}, ${notes}, ${"medium"}, ${pricing === "paid" ? "paid" : "free"} ) diff --git a/apps/api/src/middleware/auth.ts b/apps/api/src/middleware/auth.ts index a897111..1502086 100644 --- a/apps/api/src/middleware/auth.ts +++ b/apps/api/src/middleware/auth.ts @@ -91,13 +91,23 @@ export function requireSession(): MiddlewareHandler<{ return async (c, next) => { const auth = getAuth(); + // When auth isn't configured (no DATABASE_URL), production must fail closed + // with 503. Non-production with ALLOW_AUTH_BYPASS != "false" skips auth + // so catalog-only local dev and unit tests can run. if (!auth) { - if (!canBypassAuthForLocalDev(c.env)) { - return c.json( - { error: "Authentication is not configured", requestId: c.get("requestId") }, - 503 as ContentfulStatusCode, - ); + if (canBypassAuthForLocalDev(c.env)) { + await next(); + return; } + return c.json( + { error: "Authentication is not configured", requestId: c.get("requestId") }, + 503 as ContentfulStatusCode, + ); + } + + // When auth IS configured, non-production may still bypass for tests/dev + // unless the operator explicitly sets ALLOW_AUTH_BYPASS=false. + if (canBypassAuthForLocalDev(c.env)) { await next(); return; } diff --git a/apps/api/src/openapi.ts b/apps/api/src/openapi.ts index 564536a..2d9ae72 100644 --- a/apps/api/src/openapi.ts +++ b/apps/api/src/openapi.ts @@ -358,7 +358,7 @@ export const openApiDocument = { // ── Response schemas ───────────────────────────────────────── BlueprintResponse: { type: "object" as const, - required: ["idea", "recommendedStack", "alternatives", "risks", "files", "export"], + required: ["idea", "recommendedStack", "alternatives", "risks", "costEstimate", "roadmap", "files", "export"], properties: { idea: { type: "string" }, recommendedStack: { @@ -370,10 +370,75 @@ export const openApiDocument = { diagnostics: { type: "array", items: { $ref: "#/components/schemas/Diagnostic" } }, rationale: { type: "string" }, explanationSource: { type: "string", enum: ["heuristic", "ai"] }, + keyReasons: { type: "array", items: { type: "string" } }, + confidence: { type: "number", minimum: 0, maximum: 1 }, + }, + }, + alternatives: { + type: "array", + items: { + type: "object", + properties: { + id: { type: "string" }, + name: { type: "string" }, + toolIds: { type: "array", items: { type: "string" } }, + harmonyScore: { type: "number" }, + tradeoffs: { type: "array", items: { type: "string" } }, + tradeoffSource: { type: "string", enum: ["heuristic", "ai"] }, + whyNot: { + type: "object", + properties: { + reason: { type: "string" }, + betterFor: { type: "string" }, + }, + required: ["reason"], + }, + }, }, }, - alternatives: { type: "array", items: { type: "object", properties: { id: { type: "string" }, name: { type: "string" }, toolIds: { type: "array", items: { type: "string" } }, harmonyScore: { type: "number" }, tradeoffs: { type: "array", items: { type: "string" } }, tradeoffSource: { type: "string", enum: ["heuristic", "ai"] } } } }, risks: { type: "array", items: { type: "string" } }, + costEstimate: { + type: "object", + properties: { + items: { + type: "array", + items: { + type: "object", + properties: { + toolId: { type: "string" }, + toolName: { type: "string" }, + pricingModel: { type: "string", enum: ["free", "free-tier", "paid"] }, + estimatedMonthlyCost: { type: ["number", "null"] }, + note: { type: "string" }, + }, + }, + }, + totalMonthlyEstimate: { type: "number" }, + totalAnnualEstimate: { type: "number" }, + currency: { type: "string", enum: ["USD"] }, + }, + }, + roadmap: { + type: "object", + properties: { + phases: { + type: "array", + minItems: 2, + maxItems: 5, + items: { + type: "object", + properties: { + name: { type: "string" }, + duration: { type: "string" }, + tasks: { type: "array", items: { type: "string" } }, + }, + required: ["name", "duration", "tasks"], + }, + }, + totalEstimate: { type: "string" }, + }, + required: ["phases", "totalEstimate"], + }, files: { type: "array", items: { type: "object", properties: { path: { type: "string" }, content: { type: "string" } } } }, export: { type: "object", description: "Full export data including log and metadata" }, }, diff --git a/apps/api/src/test-setup.ts b/apps/api/src/test-setup.ts new file mode 100644 index 0000000..6b1ca97 --- /dev/null +++ b/apps/api/src/test-setup.ts @@ -0,0 +1,18 @@ +/** + * Vitest setup for apps/api. + * + * Runs before any test file is imported (see vitest.config.ts). + * Forces the AI explainer to the deterministic "heuristic" mode so + * unit tests don't hit live Gemini/OpenAI APIs, and clears any + * stray DATABASE_URL inherited from the shell so auth middleware + * exercises the non-auth local-dev path by default. + */ + +process.env.AI_PROVIDER = "heuristic"; +delete process.env.GEMINI_API_KEY; +delete process.env.OPENAI_API_KEY; +delete process.env.DATABASE_URL; +delete process.env.BETTER_AUTH_SECRET; + +// Each test opts into prod/auth behavior explicitly via c.env in app.request. +// The global here just keeps the default path deterministic. diff --git a/apps/api/tsconfig.json b/apps/api/tsconfig.json index 0f80f4f..8f24167 100644 --- a/apps/api/tsconfig.json +++ b/apps/api/tsconfig.json @@ -2,9 +2,7 @@ "extends": "../../tsconfig.base.json", "compilerOptions": { "outDir": "./dist", - "rootDir": "./src", - "moduleResolution": "NodeNext", - "module": "NodeNext" + "rootDir": "./src" }, "include": ["src/**/*"] } diff --git a/apps/api/vitest.config.ts b/apps/api/vitest.config.ts new file mode 100644 index 0000000..23ec6d5 --- /dev/null +++ b/apps/api/vitest.config.ts @@ -0,0 +1,11 @@ +import { defineConfig } from "vitest/config"; + +export default defineConfig({ + test: { + environment: "node", + passWithNoTests: true, + // Set env vars before app.ts is imported so AI_PROVIDER resolves + // to "heuristic" and live-API keys are not read during tests. + setupFiles: ["./src/test-setup.ts"], + }, +}); diff --git a/apps/web/index.html b/apps/web/index.html index ae33a48..74be42b 100644 --- a/apps/web/index.html +++ b/apps/web/index.html @@ -27,7 +27,7 @@ style-src 'self' 'unsafe-inline'; img-src 'self' data: https:; font-src 'self' data:; - connect-src 'self'; + connect-src 'self' http://localhost:* http://127.0.0.1:*; worker-src 'self' blob:; child-src 'self' blob:; " /> diff --git a/apps/web/tsconfig.json b/apps/web/tsconfig.json index ae39103..5bd7303 100644 --- a/apps/web/tsconfig.json +++ b/apps/web/tsconfig.json @@ -6,7 +6,6 @@ "moduleResolution": "Bundler", "allowImportingTsExtensions": true, "noEmit": true, - "baseUrl": ".", "paths": { "@/*": ["./src/*"] }, diff --git a/apps/web/vite.config.ts b/apps/web/vite.config.ts index 7cd4ccb..86ca80d 100644 --- a/apps/web/vite.config.ts +++ b/apps/web/vite.config.ts @@ -9,6 +9,18 @@ export default defineConfig({ '@': path.resolve(__dirname, './src'), }, }, + server: { + port: 5173, + strictPort: true, + // Proxy API calls during dev so the browser sees a same-origin request + // and cookies from /api/auth/* flow naturally without CORS round-trips. + proxy: { + '/api': { + target: 'http://localhost:3000', + changeOrigin: true, + }, + }, + }, build: { sourcemap: true, target: 'es2020', diff --git a/attached_assets/1751049443547.jpg b/attached_assets/1751049443547.jpg deleted file mode 100644 index 904aa76..0000000 Binary files a/attached_assets/1751049443547.jpg and /dev/null differ diff --git a/attached_assets/AI Coding Tool Database Creation.docx_1754841204571.pdf b/attached_assets/AI Coding Tool Database Creation.docx_1754841204571.pdf deleted file mode 100644 index 7607d2b..0000000 Binary files a/attached_assets/AI Coding Tool Database Creation.docx_1754841204571.pdf and /dev/null differ diff --git a/attached_assets/CODEBASE_REVIEW_1756933135786.md b/attached_assets/CODEBASE_REVIEW_1756933135786.md deleted file mode 100644 index fcfee22..0000000 --- a/attached_assets/CODEBASE_REVIEW_1756933135786.md +++ /dev/null @@ -1,127 +0,0 @@ -# Comprehensive Codebase Review - January 16, 2025 - -## Executive Summary -After thorough review, the TechStack Explorer + StackFast merger is **95% complete** with most features operational. Found 3 missing features and 2 API endpoint issues that need fixing. - -## ✅ Working Features (Verified) - -### Database & Core Functionality -- ✓ **11 tools** properly loaded in database -- ✓ **55 compatibility relationships** established -- ✓ **7 categories** functioning correctly -- ✓ PostgreSQL integration working perfectly -- ✓ Drizzle ORM schemas properly configured - -### Frontend Pages (8 pages total) -1. ✓ **Dashboard** - Statistics, popular tools, quick actions -2. ✓ **Tool Database** - Search, filter, view tools -3. ✓ **Compare Tools** - Side-by-side comparison -4. ✓ **Stack Builder** - Build and validate tech stacks -5. ✓ **Compatibility Matrix** - 4-tab view with Matrix, Heatmap, Migration, Insights -6. ✓ **Analytics** - Charts and insights -7. ✓ **Blueprint Builder** - Generate blueprints with AI -8. ✓ **404 Not Found** - Error page - -### API Endpoints (Tested) -- ✓ GET `/api/tools` - Returns 11 tools -- ✓ GET `/api/tools/quality` - Quality filtered tools -- ✓ GET `/api/categories` - Returns 7 categories -- ✓ GET `/api/compatibility-matrix` - Returns 55 relationships -- ✓ GET `/api/v1/migration/:fromTool/:toTool` - Migration paths working -- ✓ POST `/api/v1/blueprint` - Blueprint generation working -- ✓ POST `/api/v1/tools/recommend` - Returns recommendations (but empty array issue) -- ✓ POST `/api/v1/stack/compatibility-report` - Compatibility analysis - -### New Phase 4 Features -- ✓ **Compatibility Heatmap** - Visual matrix with color coding -- ✓ **Migration Wizard** - Step-by-step migration planning -- ✓ **Export functionality** - JSON export for migration plans -- ✓ **Enhanced UI** - 4-tab layout in Compatibility Matrix - -## ❌ Issues Found - -### 1. API Endpoint Issues -**Problem**: Stack analysis endpoint not working correctly -```bash -POST /api/v1/stack/analyze -# Expected: {"harmonyScore": 58.3, ...} -# Actual: {"message": "Please provide at least 2 tool IDs"} -``` -**Issue**: The endpoint expects `toolIds` but the frontend/docs say `toolNames` - -**Problem**: Tool recommendations returning empty -```bash -POST /api/v1/tools/recommend -# Returns: {"recommendations": []} instead of actual tools -``` -**Issue**: Category matching logic may be failing - -### 2. Missing Features (TODOs found) -1. **Add Tool Dialog** (client/src/App.tsx:43) - - No component exists for adding new tools - - Button exists but only logs to console - -2. **Edit Tool Functionality** (tool-database.tsx, compatibility-matrix.tsx) - - Edit buttons exist but no implementation - - Need edit dialogs/forms - -### 3. Storage Interface Gap -**Fixed**: Added `getToolByName` method (was missing, now implemented) - -## 🔍 Code Quality Analysis - -### Good Practices Found -- ✓ TypeScript types properly defined -- ✓ Consistent component structure -- ✓ Proper error handling in most places -- ✓ Clean separation of concerns -- ✓ No LSP errors detected - -### Areas for Improvement -- Some components are large (compatibility-matrix.tsx: 265 lines) -- Duplicate code in edit handlers -- Mock data still present in some places - -## 📊 Statistics -- **Total Tools**: 11 (should have 51 based on docs) -- **Compatibility Entries**: 55 -- **Categories**: 7 -- **Pages**: 8 -- **API Endpoints**: 15+ -- **Components**: 30+ - -## 🔧 Recommended Fixes - -### Priority 1: Fix Stack Analysis API -Need to update the endpoint to accept `toolNames` properly or fix the request format. - -### Priority 2: Implement Add Tool Dialog -Create a dialog component for adding new tools with form validation. - -### Priority 3: Implement Edit Functionality -Add edit dialogs for tools in both Tool Database and Compatibility Matrix. - -### Priority 4: Load All 51 Tools -The seed data shows 51 tools but only 11 are loaded. Need to check data initialization. - -### Priority 5: Fix Tool Recommendations -The recommendation endpoint returns empty arrays - need to debug the category matching. - -## Summary -The platform is **highly functional** with all major features working. The integration between TechStack Explorer and StackFast is successful. - -## ✅ Issues Fixed (January 16, 2025) -1. **API Endpoint Issues - FIXED** - - Stack analysis now accepts both `toolIds` and `toolNames` - - Tool recommendations returning proper results - - Migration paths working correctly - -2. **Add Tool Dialog - IMPLEMENTED** - - Full dialog component created - - Form validation working - - Successfully creates new tools - - Integrated with main app - -3. **Remaining TODO**: Edit Tool functionality still needs implementation - -**Overall Grade**: A- (All critical features working, only edit functionality remaining) \ No newline at end of file diff --git a/attached_assets/Coding tool profile database setup_1754841204572.csv b/attached_assets/Coding tool profile database setup_1754841204572.csv deleted file mode 100644 index 38efb5f..0000000 --- a/attached_assets/Coding tool profile database setup_1754841204572.csv +++ /dev/null @@ -1,60 +0,0 @@ -Name,Categories,Description,URL,Frameworks,Features,Native Integrations,Verified Integrations,Notable Strengths,Known Limitations,Maturity Score,Popularity Score,Pricing -Lovable,"Design/frontend, Coding tool, Vibe coding",AI-powered platform for creating full-stack websites via natural language.,lovable.dev,"React, TypeScript, Tailwind CSS, Vite","Website and app builder, UI design, templates","GitHub, Supabase, Stripe, Figma","OpenAI, Anthropic, Resend, Clerk, Three.js, D3.js, Highcharts, p5.js, Runware, ElevenLabs, Make, Replicate, Stability AI, Twilio, n8n","End-to-end automation, great for MVPs, user-friendly for non-coders","Limited custom logic, platform lock-in",8.3,8.9,"Free tier, $25 pro tier" -ChatGPT,"Coding tool, Vibe coding","Conversational AI for code generation, debugging, and programming assistance.",https://chatgpt.com,"React, Django, Flask (via code gen)","Code generation, debugging, explanation, natural language to code","OpenAI API, GitHub Copilot","VS Code, Jupyter, various LLMs","Versatile, excellent for learning, vast knowledge base","Inaccurate/secure code issues, limited context window",9.5,9.8,"Free tier, Plus $20/month, Team/Enterprise custom" -Gemini (CLI),"Coding tool, Agentic framework",Google's AI with CLI for code generation and multimodal inputs.,https://gemini.google.com,"Android, Web, Flutter","Code Assist, multimodal prompts, CLI, Google Cloud integration","Google Cloud, Android Studio","VS Code, JetBrains","Multimodal coding, fast inference, good for mobile/web","Limited offline use, context window constraints",9,9.2,"Free with limits, Pro $20/month" -Cody,"Coding tool, Agentic framework","Enterprise AI code assistant for complex codebases, speed, and consistency.",https://sourcegraph.com/cody,All code hosts/editors,"Accelerates dev, reusable prompts, enterprise-grade security",All code hosts/editors,Not specified,"Trusted by enterprises, saves 5-6 hours/week, doubles coding speed",Not specified,8,8,Not specified -Claude/Claude Code,"Design/frontend, Coding tool, Agentic framework, IDE",AI for developers to write/test/debug/analyze codebases.,https://www.anthropic.com/solutions/coding,Not specified,"Write/test/debug, codebase analysis, GitHub integration, terminal embedding","GitHub, GitLab, Vercel","Cursor, Sourcegraph, Replit, Cognition, Windsurf, Zed, Copilot, Augment Code, Block, Rakuten","Leads SWE-bench (74.5%), 95% test time reduction, clean code",Not specified,8,9,Not specified -GitHub Copilot,"Design/frontend, Coding tool, Agentic framework, IDE",AI pair programmer for contextualized code assistance.,https://github.com/features/copilot,"JavaScript, OpenAI GPT-5, Claude Opus 4.1, Gemini 2.0 Flash","Code completions, chat, explanations, code review, Autofix","VS Code, Visual Studio, Vim, Neovim, JetBrains, Azure Data Studio, GitHub CLI/Mobile",Not specified,"Widely adopted, 55% productivity boost, multi-model support","Lower quality for niche languages, insecure code risks",9,9.5,"Free: $0, Pro: $10/month, Pro+: $39/month, Business/Enterprise custom" -IBM watsonx Code Assistant,"Design/frontend, Coding tool, Agentic framework, IDE",AI for faster code creation and modernization across SDLC.,https://www.ibm.com/products/watsonx-code-assistant,"Python, Java, C, C++, Go, JavaScript, TypeScript","Chat recommendations, automate tasks, generate/explain/test code, IP indemnification",Not specified,Not specified,"IDC MarketScape leader, 90% time savings, 80% legacy code transformed",Not specified,8,7,"30-day free trial, 25% off Essentials Plan for 3 months" -AI2sql,"Coding tool, Database/backend",Generates complex SQL/NoSQL queries from natural language.,https://ai2sql.io,"SQL, NoSQL","Natural language to SQL/NoSQL, multi-database support, specialized SQL tools",Not specified,Not specified,"Simplifies SQL for non-experts, supports SQL/NoSQL",Requires some prior knowledge,7,8,Not specified -Reflection AI,"Coding tool, Agentic framework",AI code research agent for complex codebases and engineering systems.,https://reflection.ai,Not specified,"Understands codebases, engineering systems, tribal knowledge",Not specified,Not specified,"Team from DeepMind/OpenAI/Anthropic, focuses on LLM/RL/agents",Not specified,3,2,Not specified -Semantic Kernel,"Coding tool, Agentic framework","Open-source kit for building AI agents with C#, Python, Java.",https://learn.microsoft.com/en-us/semantic-kernel/overview/,"C#, Python, Java","Build AI agents, integrate AI models, modular plugins, OpenAPI support",Not specified,Not specified,"Flexible, Microsoft-backed, enterprise-ready security",Not specified,8,7,Not specified -Kiro AI,"Design/frontend, Coding tool, Agentic framework, IDE",AI IDE for spec-driven development and collaboration.,https://kiro.dev,"Claude Sonnet 3.7/4, Open VSX plugins","Spec-driven dev, multimodal chat, agent hooks, autopilot, MCP integration",MCP for docs/databases/APIs,Not specified,"Structures AI coding, automates tasks, multimodal inputs",Specific model support limits flexibility,7,6,Free to start -ByteAI,"Design/frontend, Coding tool, Agentic framework, IDE",Smart UML playground for technical strategies with AI tips.,https://byte-ai.io,"JavaScript, Python, Node.js, C#, C++","Visual module builder, team collaboration, code assistant, AI tips",Future GitHub integration,Not specified,"Visualization, 55% coding speed increase, reduces tech debt","Requires module knowledge, AI code needs review",6,5,"Free Trial: $0/mo, Startup: $45/mo, Company: $299/mo, Custom" -GibsonAI,"Database/backend, Agentic framework, IDE",AI for instant serverless SQL database design/deployment/management.,https://www.gibsonai.com,"PostgreSQL, MySQL, Neon, Windsurf, Cursor, VScode, CLI, Python, TypeScript, NextJS","Instant schema, zero downtime migrations, API endpoints, natural language to SQL","PostgreSQL, MySQL, Neon, Windsurf, Cursor, VScode, CLI, etc.",Not specified,"Speed in database creation, AI-native, cost-efficient",Not specified,5,4,Free to start -Knack,"Design/frontend, Database/backend","No-code platform for data-rich web apps like SaaS, portals, internal tools.",https://www.knack.com,Not specified,"Visual builder, no-code database, automation, triggers, templates",Not specified,Not specified,"Rapid development, predictable costs, 92% retention",Not specified,8,7,Not specified -Bolt,"Design/frontend, Coding tool, Vibe coding",AI web builder for creating apps/sites via natural language.,https://bolt.new,"React, Next.js","Natural language app building, UI generation, code export, rapid prototyping","Stripe, GitHub","OpenAI, Anthropic","Easiest vibe coding, fast MVP creation, user-friendly","Limited to web apps, needs code tweaks",7.5,8.2,Not specified -Cursor,"Design/frontend, Coding tool, Agentic framework, IDE",AI code editor for predicting edits and natural language coding.,https://www.cursor.com,Not specified,"Predicts edits, answers codebase queries, natural language editing",Not specified,Not specified,"Trusted by Samsung/Stripe/Shopify, fast autocompletion",Not specified,7,8,Not specified -v0,"Design/frontend, Coding tool, Vibe coding",Vercel's AI tool for generating UI components from natural language.,https://v0.dev,"React, Tailwind CSS","AI UI generation, code export, natural language to design, templates","Vercel, GitHub",Not specified,"Fast UI prototyping, Vercel ecosystem integration, high-quality code","Focused on frontend, limited custom backend",8,8.5,Not specified -Tempo Labs,"Design/frontend, Coding tool, Agentic framework",Platform for collaborative React app building with AI and drag-and-drop.,https://www.tempo.new,React,"Visual React editing, design systems, VSCode/GitHub integration, AI generation","GitHub, VSCode, Storybook",Not specified,"Designer/developer collaboration, visual editing, free/paid AI",Free plan limited to 30 prompts,6,5,"Free: $0, Pro: $30/month, Agent+: $4,000/month" -Base44,"Design/frontend, Coding tool, Agentic framework, Database/backend",AI platform for turning ideas into custom apps without coding.,https://base44.com,Not specified,"Build apps in minutes, auto components/pages/flows, backend (auth, data), hosting","Email, SMS, external APIs, database querying",Not specified,"No coding required, fast deployment, 400K+ users",Not specified,7,8,"Free core features, paid from $20/month" -Replit,"Design/frontend, Coding tool, Agentic framework, IDE, Database/backend",Platform for turning ideas into apps with vibe coding and AI Agent.,https://replit.com,Not specified,"Replit Agent, design imports from Figma, built-in Database/Auth, vibe coding, SSO","Database, Auth, Stripe, OpenAI",Not specified,"Loved by 40M creators, trusted by Google/Anthropic/Coinbase",Not specified,8,9,Not specified -gocodeo,Coding tool,AI unit test generator for automating code testing.,https://www.gocodeo.com,Not specified,"AI code generation, project setup, testing, real-time AI coding, auto-debugging",VS Code,Not specified,"Trusted by 25,000+ engineers, 55% coding speed increase",Not specified,7,8,Not specified -Devin,"Coding tool, Agentic framework, Database/backend","AI software engineer for coding tasks like migration, refactoring, bug fixing.",https://devin.ai,Not specified,"Code migration, refactoring, data engineering, bug/backlog resolution","GitHub, Linear, Slack","Asana, Zapier, Confluence, Airtable, Segment, Notion, Stripe, AWS, Datadog, Databricks, Google Drive, Sentry, PostgreSQL, Azure, Snowflake, MongoDB","8-12x efficiency gains, 20x cost savings, reduces errors","Needs oversight, initial fine-tuning",7,8,Not specified -Softgen,"Design/frontend, Coding tool, Agentic framework",AI tool for creating web apps via natural language with tailored roadmaps.,https://softgen.ai,Not specified,"AI roadmap, emails, payments, auth, database, SEO, UI components","Emails, Payments, Auth, Database, Realtime Database, Cloud Storage, SEO, UI Components",Not specified,Not specified,Not specified,5,6,Not specified -Windsurf,"Design/frontend, Coding tool, Agentic framework, IDE",AI-powered IDE with deep codebase understanding and real-time collaboration.,https://codeium.com/windsurf,Not specified,"Contextual awareness, autocomplete, Previews, linter, MCP, in-line/terminal commands",Not specified,Not specified,"Writes 70M+ lines daily, 1M+ users, 94% AI code, 59% Fortune 500",Not specified,8,9,Not specified -Cline,"Design/frontend, Coding tool, Agentic framework, IDE",Autonomous coding agent in IDE for file creation/editing and web tasks.,https://github.com/cline/cline,"OpenRouter, Anthropic, OpenAI, Google Gemini, AWS Bedrock, Azure, GCP Vertex, etc.","File analysis/editing, terminal commands, headless browser, MCP, context via @mentions",VSCode,Not specified,"Handles complex tasks, supports large projects, interactive debugging","Requires permission, model-specific dependencies",7,6,Not specified -Codev,"Design/frontend, Coding tool, Agentic framework, IDE, Database/backend",Converts text to full-stack Next.js apps with deployment and ownership.,https://www.co.dev,"Next.js, Supabase (PostgreSQL)","Text to app, components/styling/functionality, package install, domain setup, CRUD","Next.js, Supabase",Not specified,"Rapid community growth (40K+ builders), production-ready in minutes","Not for complex apps, web only, review for security/scaling",7,8,Not specified -AIder,"Coding tool, Agentic framework",AI pair programming tool for terminal-based collaboration with LLMs.,https://aider.chat,"Python, DeepSeek, Claude 3.7 Sonnet, o3-mini","Pair programming, start/work on projects, supports multiple LLMs",Not specified,Not specified,"AI-assisted terminal coding, multi-LLM support",Not specified,5,3,Not specified -Tabnine,"Coding tool, Agentic framework, IDE",Contextually aware AI platform for speeding up development with air-gapped deployments.,https://www.tabnine.com,Popular languages/libraries/IDEs,"Context-aware suggestions, bespoke models, AI agents for review/testing/docs",Not specified,Atlassian Jira,"Gartner #1, 11% productivity boost, custom suggestions",Potential latency issues,8,9,Not specified -Bubble,"Design/frontend, Coding tool, Database/backend, Vibe coding",Full-stack no-code app builder with visual editing and backend.,https://bubble.io,Not specified,"Visual app builder, databases, workflows, integrations, hosting","Stripe, Google, various APIs",Not specified,"Easy no-code, full-stack, trusted for MVPs","Performance for large apps, lock-in",8.5,8.7,"Free tier, paid from $25/month" -Supabase,Database/backend,"Postgres development platform with database, auth, APIs, and more.",https://supabase.com,"ReactJS, NextJS, RedwoodJS, Flutter, Kotlin, SvelteKit, SolidJS, Vue, NuxtJS, Refine","Postgres database, Auth, APIs, Edge Functions, Realtime, Storage, Vector embeddings",Not specified,Not specified,"Trusted by Mozilla/GitHub/1Password, quick build/scale",Not specified,8,9,Not specified -Firebase,"Design/frontend, Coding tool, Agentic framework, Database/backend",Platform for app development with AI-powered experiences.,https://firebase.google.com,"iOS, Android, Web, Flutter, Unity, C++","Build AI experiences, managed infra, launch/monitor/iterate, Gemini integration","Gemini, Google Cloud",Not specified,"Google-backed, trusted by NPR/Duolingo, millions of users",Not specified,9,9,Not specified -Appwrite,"Coding tool, Database/backend, Agentic framework","Open-source backend platform with auth, databases, and hosting.",https://appwrite.io,13 languages for serverless functions,"Auth, scalable databases, secure storage, serverless, messaging, Realtime, hosting","All Appwrite products (Auth, Databases, Storage, etc.)",Not specified,"Loved by Apple/Oracle/TikTok/IBM, wide product range, global scaling",Not specified,8,8,"Free: $0, Pro: $15/month, Scale: $599/month, Enterprise: custom" -Nhost,Database/backend,"Managed, extensible backend platform for speed, flexibility, and scale.",https://nhost.io,SDKs (specific not detailed),"Scales with user, CI/CD, observability, CLI/dashboard, global deployment, auth SDKs",Not specified,Not specified,"Rapid dev, case studies (400K+ users in 6 weeks), reduces onboarding",Not specified,7,7,Free tier -UI Bakery,"Design/frontend, Coding tool, Agentic framework","Low-code platform for building custom internal tools, portals, dashboards.",https://uibakery.io,"JavaScript, Python, SQL","Drag-and-drop UI, 30+ integrations, code/no-code logic, Git, one-click deployment","18+ databases, 17+ services/APIs, REST/OpenAPI/GraphQL",Not specified,"Rapid dev, high customization, G2 4.9/5",Not specified,8,8,See https://uibakery.io/pricing -Pocketbase,"Database/backend, Coding tool","Open-source backend in 1 file with database, auth, storage, and dashboard.",https://pocketbase.io,JavaScript (SDK),"Realtime database, auth, file storage, admin dashboard, CRUD operations",Not specified,Not specified,"Ready to use, integrates with frontend stacks",Not specified,5,5,Not specified -Backendless,"Design/frontend, Coding tool, Agentic framework, IDE, Database/backend",Platform for scalable apps with AI-driven automation.,https://backendless.com,Not specified,"Build scalable apps, automate workflows, no-code/low-code, flexible hosting",Not specified,Not specified,"Flexible backend, intuitive interface, quick POC",Not specified,7,6,Cloud/Pro/Managed plans -Northflank,"Design/frontend, Coding tool, Agentic framework, IDE, Database/backend",Cloud platform for deploying any project from first user to billions.,https://northflank.com,"Any language/framework, GitHub/GitLab/Bitbucket, Kubernetes (EKS/GKE/AKS)","UI/CLI/APIs/GitOps, runs on AWS/GCP/Azure/Oracle, templates, secure code, vectorDBs","GitHub, GitLab, Bitbucket",Not specified,"Trusted by 2,000+ startups/enterprises, scales to 3M users",Not specified,8,8,"CPU $0.01667/hr, Memory $0.00833/hr, NVIDIA H100 $2.74/hr, etc." -Vercel,"Design/frontend, Coding tool, Agentic framework, Database/backend","Developer tools and cloud infra for faster, personalized web.",https://vercel.com,Not specified,"Build/deploy on AI Cloud, Git deploys, collaborative previews, AI Gateway, rollbacks",Not specified,Not specified,"95% page load reduction, globally performant, collaborative",Not specified,8,8,Not specified -Netlify,"Design/frontend, Coding tool, Agentic framework",Platform for deploying modern frontend stacks with AI apps.,https://netlify.com,Not specified,"Optimized builds, collaborative previews, instant rollbacks, global edge, serverless",Not specified,Not specified,"35M+ projects, 7M+ developers, 99.99% uptime",Not specified,9,9,Not specified -Render,"Coding tool, Database/backend","Cloud platform for building, deploying, scaling apps.",https://render.com,"Node.js, Python, Ruby, Docker","Web services/static sites/cron jobs, auto deploys, datastores, autoscaling, IaC",Slack,Not specified,"3M+ developers, 100B requests/month, enterprise-grade",Not specified,8,9,Not specified -Platform.sh,"Database/backend, Coding tool","Self-service PaaS for efficient, reliable, secure infrastructure.",https://platform.sh,"100+ frameworks, 14 languages","Automated infra, Git workflows, multicloud/multistack, scalability, Observability Suite",Not specified,Not specified,"5,000+ customers (Adobe/Economist), 219% ROI, G2 leader",Not specified,8,8,Not specified -Figma,"Design/frontend, Vibe coding",Collaborative interface design tool for design/development teams.,https://figma.com,Not specified,"Create/refine products, mockups, design to code, design systems, collaboration",Not specified,Not specified,"Trusted by AirBnb/Asana/Atlassian/GitHub, seamless collaboration",Not specified,8,9,Not specified -Balsamiq,Design/frontend,"Wireframing tool for quick, low-fidelity wireframes to align teams.",https://balsamiq.com,Not specified,"Drag-and-drop UI, share via links/exports, low-fidelity design, templates",Not specified,Not specified,"Reduces rework, aligns teams, easy to use",Lacks advanced features,8,8,Not specified -LangChain,"Coding tool, Agentic framework",Open-source framework for building AI agents with LLMs.,https://www.langchain.com,"Python, JavaScript","Agent building, LLM integrations, chaining prompts/tools, memory, RAG","OpenAI, Anthropic, various databases","Hugging Face, Pinecone","Flexible for agentic AI, widely used, community support","Learning curve, debugging agents",8.5,9,Not specified -CrewAI,"Agentic framework, Coding tool",Framework for orchestrating role-playing autonomous AI agents.,https://crewai.com,Python,"Role-based agents, task delegation, multi-agent workflows, LLM integration","OpenAI, Anthropic",Not specified,"Easy multi-agent setup, good for automation, community","Limited to Python, agent reliability varies",7.5,8,Not specified -AutoGen,"Agentic framework, Coding tool",Microsoft's framework for building multi-agent AI systems.,https://microsoft.github.io/autogen/,Python,"Multi-agent orchestration, event-driven architecture, API integration","Microsoft Azure, OpenAI",Not specified,"Strong for enterprise, good docs, Semantic Kernel integration",Requires setup for advanced use,8,8,Not specified -Codeium,"Coding tool, IDE","AI code completion tool with suggestions, chat, and search in IDEs.",https://codeium.com,70+ languages,"Autocomplete, chat for code, search codebase, enterprise self-host","VS Code, JetBrains, Neovim",Not specified,"Free for individuals, fast, privacy-focused",Less context-aware than Copilot for some,8,8.5,Not specified -Amazon CodeWhisperer,"Coding tool, IDE",AI coding companion with AWS integration for code suggestions.,https://aws.amazon.com/codewhisperer/,15+ languages,"Code suggestions, security scans, reference tracker, AWS-specific code","AWS, VS Code, JetBrains",Not specified,"Free for individuals, good for cloud devs, security focus","Biased towards AWS, less versatile",8,7.5,Not specified -Zed,"IDE, Coding tool","High-performance, collaborative code editor with AI integrations.",https://zed.dev,"Rust-based, multiple languages","AI autocomplete, collaboration, high speed, Git integration","GitHub Copilot, OpenAI",Not specified,"Fastest editor, multiplayer editing, modern UI","Newer, less plugins than VS Code",7,7,Not specified -Stripe,Payment platform,Payment processing platform for online payments and financial services.,https://stripe.com,"JavaScript, Python, Ruby, etc.","Payments, billing, fraud prevention, global support, APIs","Many e-commerce platforms, Next.js, Shopify","Supabase, Vercel, Bubble","Developer-friendly APIs, reliable, scales for enterprises","Fees per transaction, compliance requirements",9.5,9.7,Not specified -Plaid,Payment platform,"Connects bank accounts for payments, verification, and financial data.",https://plaid.com,SDKs for various languages,"Bank connections, transactions, identity verification, payments","Stripe, Venmo, many fintech apps",Not specified,"Secure bank links, wide coverage, easy integration","US-focused, privacy concerns",9,8.5,Not specified -Uizard,"Design/frontend, Vibe coding",AI-powered UI design tool for rapid prototyping from prompts/sketches.,https://uizard.io,"Exports to React, Figma","AI UI generation, prototyping, collaboration, export code","Figma, Adobe XD",Not specified,"Fast from prompt to UI, focused on design","Limited to UI, not full code",7,7.5,Not specified -Locofy.ai,"Design/frontend, Coding tool",Converts Figma/Adobe XD designs to code automatically.,https://www.locofy.ai,"React, HTML/CSS, Gatsby","Design to code conversion, component export, responsive code","Figma, Adobe XD",Not specified,"Saves time on frontend coding, accurate conversions","Best for simple designs, may need tweaks",6.5,7,Not specified -Blackbox,"Coding tool, Agentic framework, IDE","AI-powered coding assistant for code generation, autocompletion, and debugging.",https://www.blackbox.ai,"Python, JavaScript, TypeScript, Go, C, C++, Java, C#","Code generation, autocompletion, debugging, Figma to code, image to web app, voice interaction","VS Code, GitHub",Not specified,"Trusted by 10M+ users, supports 70+ languages, Figma/image to code","May require manual code review, limited offline use",8,8.5,"Free, Free Trial, Free Version" -PSEUDO.AI,"Coding tool, Vibe coding",AI-powered platform for generating pseudocode from natural language prompts.,https://pseudo.ai,Not specified,"Pseudocode generation, natural language to pseudocode, algorithm visualization",Not specified,Not specified,"Simplifies algorithm design, beginner-friendly","Limited to pseudocode, not executable code",6,5,Not specified -Build AI,"Design/frontend, Coding tool, Vibe coding",No-code platform for building AI-powered apps and websites via natural language.,https://www.buildai.space,Not specified,"App/website builder, natural language interface, AI-driven design, hosting",Not specified,Not specified,"User-friendly for non-coders, rapid prototyping",Limited customization for complex apps,6.5,6,Not specified -CodeGeeX,"Coding tool, IDE",Multilingual code generation model with 13B parameters for 20+ languages.,https://codegeex.cn,"C, C++, Go, Java, JavaScript, Python, C#, Angular","Code generation, translation, explanation, summarization, VS Code extension",VS Code,Not specified,"Supports 20+ languages, few-shot learning, style customization","Limited to code generation, less contextual awareness",7.5,7.8,"Free, Free Trial, Free Version" -HeyBoss,"Design/frontend, Coding tool, Vibe coding, Database/backend","No-code AI builder for websites/apps in minutes, with built-in CRM, SEO, payments.",https://heyboss.ai,Not specified,"Website/app builder, CRM, SEO, payment integration, custom internal tools, real-time analytics","OpenAI, Stripe, databases",Not specified,"Builds in 5-9 minutes, no coding needed, full-stack automation","Limited for complex logic, potential platform lock-in",7.8,8.2,"Subscription plans, see https://heyboss.ai" -Manus AI,"Coding tool, Agentic framework",AI-driven platform for generating and managing code for software projects.,https://manus.im,Not specified,"Code generation, project management, automation of coding tasks",Not specified,Not specified,"Streamlines project workflows, good for small teams","Limited public info, may lack advanced integrations",5.5,5,Not specified \ No newline at end of file diff --git a/attached_assets/Coding tool profile database setup_1754841204573.md b/attached_assets/Coding tool profile database setup_1754841204573.md deleted file mode 100644 index 8064770..0000000 --- a/attached_assets/Coding tool profile database setup_1754841204573.md +++ /dev/null @@ -1,62 +0,0 @@ -| Name | Categories | Description | URL | Frameworks | Features | Native Integrations | Verified Integrations | Notable Strengths | Known Limitations | Maturity Score | Popularity Score | Pricing | -|-----------------------|------------------------------------------------|-----------------------------------------------------------------------------|--------------------------------|---------------------------------------------------------------------------|------------------------------------------------------------------------------------------|-------------------------------------------------------------|-----------------------------------------------------------------------|----------------------------------------------------------------------------------|----------------------------------------------------------------|---------------|----------------|-------------------------------------| -| Lovable | Design/frontend, Coding tool, Vibe coding | AI-powered platform for creating full-stack websites via natural language. | lovable.dev | React, TypeScript, Tailwind CSS, Vite | Website and app builder, UI design, templates | GitHub, Supabase, Stripe, Figma | OpenAI, Anthropic, Resend, Clerk, Three.js, D3.js, Highcharts, p5.js, Runware, ElevenLabs, Make, Replicate, Stability AI, Twilio, n8n | End-to-end automation, great for MVPs, user-friendly for non-coders | Limited custom logic, platform lock-in | 8.3 | 8.9 | Free tier, $25 pro tier | -| ChatGPT | Coding tool, Vibe coding | Conversational AI for code generation, debugging, and programming assistance.| https://chatgpt.com | React, Django, Flask (via code gen) | Code generation, debugging, explanation, natural language to code | OpenAI API, GitHub Copilot | VS Code, Jupyter, various LLMs | Versatile, excellent for learning, vast knowledge base | Inaccurate/secure code issues, limited context window | 9.5 | 9.8 | Free tier, Plus $20/month, Team/Enterprise custom | -| Gemini (CLI) | Coding tool, Agentic framework | Google's AI with CLI for code generation and multimodal inputs. | https://gemini.google.com | Android, Web, Flutter | Code Assist, multimodal prompts, CLI, Google Cloud integration | Google Cloud, Android Studio | VS Code, JetBrains | Multimodal coding, fast inference, good for mobile/web | Limited offline use, context window constraints | 9.0 | 9.2 | Free with limits, Pro $20/month | -| Cody | Coding tool, Agentic framework | Enterprise AI code assistant for complex codebases, speed, and consistency. | https://sourcegraph.com/cody | All code hosts/editors | Accelerates dev, reusable prompts, enterprise-grade security | All code hosts/editors | Not specified | Trusted by enterprises, saves 5-6 hours/week, doubles coding speed | Not specified | 8.0 | 8.0 | Not specified | -| Claude/Claude Code | Design/frontend, Coding tool, Agentic framework, IDE | AI for developers to write/test/debug/analyze codebases. | https://www.anthropic.com/solutions/coding | Not specified | Write/test/debug, codebase analysis, GitHub integration, terminal embedding | GitHub, GitLab, Vercel | Cursor, Sourcegraph, Replit, Cognition, Windsurf, Zed, Copilot, Augment Code, Block, Rakuten | Leads SWE-bench (74.5%), 95% test time reduction, clean code | Not specified | 8.0 | 9.0 | Not specified | -| GitHub Copilot | Design/frontend, Coding tool, Agentic framework, IDE | AI pair programmer for contextualized code assistance. | https://github.com/features/copilot | JavaScript, OpenAI GPT-5, Claude Opus 4.1, Gemini 2.0 Flash | Code completions, chat, explanations, code review, Autofix | VS Code, Visual Studio, Vim, Neovim, JetBrains, Azure Data Studio, GitHub CLI/Mobile | Not specified | Widely adopted, 55% productivity boost, multi-model support | Lower quality for niche languages, insecure code risks | 9.0 | 9.5 | Free: $0, Pro: $10/month, Pro+: $39/month, Business/Enterprise custom | -| IBM watsonx Code Assistant | Design/frontend, Coding tool, Agentic framework, IDE | AI for faster code creation and modernization across SDLC. | https://www.ibm.com/products/watsonx-code-assistant | Python, Java, C, C++, Go, JavaScript, TypeScript | Chat recommendations, automate tasks, generate/explain/test code, IP indemnification | Not specified | Not specified | IDC MarketScape leader, 90% time savings, 80% legacy code transformed | Not specified | 8.0 | 7.0 | 30-day free trial, 25% off Essentials Plan for 3 months | -| AI2sql | Coding tool, Database/backend | Generates complex SQL/NoSQL queries from natural language. | https://ai2sql.io | SQL, NoSQL | Natural language to SQL/NoSQL, multi-database support, specialized SQL tools | Not specified | Not specified | Simplifies SQL for non-experts, supports SQL/NoSQL | Requires some prior knowledge | 7.0 | 8.0 | Not specified | -| Reflection AI | Coding tool, Agentic framework | AI code research agent for complex codebases and engineering systems. | https://reflection.ai | Not specified | Understands codebases, engineering systems, tribal knowledge | Not specified | Not specified | Team from DeepMind/OpenAI/Anthropic, focuses on LLM/RL/agents | Not specified | 3.0 | 2.0 | Not specified | -| Semantic Kernel | Coding tool, Agentic framework | Open-source kit for building AI agents with C#, Python, Java. | https://learn.microsoft.com/en-us/semantic-kernel/overview/ | C#, Python, Java | Build AI agents, integrate AI models, modular plugins, OpenAPI support | Not specified | Not specified | Flexible, Microsoft-backed, enterprise-ready security | Not specified | 8.0 | 7.0 | Not specified | -| Kiro AI | Design/frontend, Coding tool, Agentic framework, IDE | AI IDE for spec-driven development and collaboration. | https://kiro.dev | Claude Sonnet 3.7/4, Open VSX plugins | Spec-driven dev, multimodal chat, agent hooks, autopilot, MCP integration | MCP for docs/databases/APIs | Not specified | Structures AI coding, automates tasks, multimodal inputs | Specific model support limits flexibility | 7.0 | 6.0 | Free to start | -| ByteAI | Design/frontend, Coding tool, Agentic framework, IDE | Smart UML playground for technical strategies with AI tips. | https://byte-ai.io | JavaScript, Python, Node.js, C#, C++ | Visual module builder, team collaboration, code assistant, AI tips | Future GitHub integration | Not specified | Visualization, 55% coding speed increase, reduces tech debt | Requires module knowledge, AI code needs review | 6.0 | 5.0 | Free Trial: $0/mo, Startup: $45/mo, Company: $299/mo, Custom | -| GibsonAI | Database/backend, Agentic framework, IDE | AI for instant serverless SQL database design/deployment/management. | https://www.gibsonai.com | PostgreSQL, MySQL, Neon, Windsurf, Cursor, VScode, CLI, Python, TypeScript, NextJS | Instant schema, zero downtime migrations, API endpoints, natural language to SQL | PostgreSQL, MySQL, Neon, Windsurf, Cursor, VScode, CLI, etc. | Not specified | Speed in database creation, AI-native, cost-efficient | Not specified | 5.0 | 4.0 | Free to start | -| Knack | Design/frontend, Database/backend | No-code platform for data-rich web apps like SaaS, portals, internal tools. | https://www.knack.com | Not specified | Visual builder, no-code database, automation, triggers, templates | Not specified | Not specified | Rapid development, predictable costs, 92% retention | Not specified | 8.0 | 7.0 | Not specified | -| Bolt | Design/frontend, Coding tool, Vibe coding | AI web builder for creating apps/sites via natural language. | https://bolt.new | React, Next.js | Natural language app building, UI generation, code export, rapid prototyping | Stripe, GitHub | OpenAI, Anthropic | Easiest vibe coding, fast MVP creation, user-friendly | Limited to web apps, needs code tweaks | 7.5 | 8.2 | Not specified | -| Cursor | Design/frontend, Coding tool, Agentic framework, IDE | AI code editor for predicting edits and natural language coding. | https://www.cursor.com | Not specified | Predicts edits, answers codebase queries, natural language editing | Not specified | Not specified | Trusted by Samsung/Stripe/Shopify, fast autocompletion | Not specified | 7.0 | 8.0 | Not specified | -| v0 | Design/frontend, Coding tool, Vibe coding | Vercel's AI tool for generating UI components from natural language. | https://v0.dev | React, Tailwind CSS | AI UI generation, code export, natural language to design, templates | Vercel, GitHub | Not specified | Fast UI prototyping, Vercel ecosystem integration, high-quality code | Focused on frontend, limited custom backend | 8.0 | 8.5 | Not specified | -| Tempo Labs | Design/frontend, Coding tool, Agentic framework | Platform for collaborative React app building with AI and drag-and-drop. | https://www.tempo.new | React | Visual React editing, design systems, VSCode/GitHub integration, AI generation | GitHub, VSCode, Storybook | Not specified | Designer/developer collaboration, visual editing, free/paid AI | Free plan limited to 30 prompts | 6.0 | 5.0 | Free: $0, Pro: $30/month, Agent+: $4,000/month | -| Base44 | Design/frontend, Coding tool, Agentic framework, Database/backend | AI platform for turning ideas into custom apps without coding. | https://base44.com | Not specified | Build apps in minutes, auto components/pages/flows, backend (auth, data), hosting | Email, SMS, external APIs, database querying | Not specified | No coding required, fast deployment, 400K+ users | Not specified | 7.0 | 8.0 | Free core features, paid from $20/month | -| Replit | Design/frontend, Coding tool, Agentic framework, IDE, Database/backend | Platform for turning ideas into apps with vibe coding and AI Agent. | https://replit.com | Not specified | Replit Agent, design imports from Figma, built-in Database/Auth, vibe coding, SSO | Database, Auth, Stripe, OpenAI | Not specified | Loved by 40M creators, trusted by Google/Anthropic/Coinbase | Not specified | 8.0 | 9.0 | Not specified | -| gocodeo | Coding tool | AI unit test generator for automating code testing. | https://www.gocodeo.com | Not specified | AI code generation, project setup, testing, real-time AI coding, auto-debugging | VS Code | Not specified | Trusted by 25,000+ engineers, 55% coding speed increase | Not specified | 7.0 | 8.0 | Not specified | -| Devin | Coding tool, Agentic framework, Database/backend | AI software engineer for coding tasks like migration, refactoring, bug fixing.| https://devin.ai | Not specified | Code migration, refactoring, data engineering, bug/backlog resolution | GitHub, Linear, Slack | Asana, Zapier, Confluence, Airtable, Segment, Notion, Stripe, AWS, Datadog, Databricks, Google Drive, Sentry, PostgreSQL, Azure, Snowflake, MongoDB | 8-12x efficiency gains, 20x cost savings, reduces errors | Needs oversight, initial fine-tuning | 7.0 | 8.0 | Not specified | -| Softgen | Design/frontend, Coding tool, Agentic framework | AI tool for creating web apps via natural language with tailored roadmaps. | https://softgen.ai | Not specified | AI roadmap, emails, payments, auth, database, SEO, UI components | Emails, Payments, Auth, Database, Realtime Database, Cloud Storage, SEO, UI Components | Not specified | Not specified | Not specified | 5.0 | 6.0 | Not specified | -| Windsurf | Design/frontend, Coding tool, Agentic framework, IDE | AI-powered IDE with deep codebase understanding and real-time collaboration. | https://codeium.com/windsurf | Not specified | Contextual awareness, autocomplete, Previews, linter, MCP, in-line/terminal commands | Not specified | Not specified | Writes 70M+ lines daily, 1M+ users, 94% AI code, 59% Fortune 500 | Not specified | 8.0 | 9.0 | Not specified | -| Cline | Design/frontend, Coding tool, Agentic framework, IDE | Autonomous coding agent in IDE for file creation/editing and web tasks. | https://github.com/cline/cline | OpenRouter, Anthropic, OpenAI, Google Gemini, AWS Bedrock, Azure, GCP Vertex, etc. | File analysis/editing, terminal commands, headless browser, MCP, context via @mentions | VSCode | Not specified | Handles complex tasks, supports large projects, interactive debugging | Requires permission, model-specific dependencies | 7.0 | 6.0 | Not specified | -| Codev | Design/frontend, Coding tool, Agentic framework, IDE, Database/backend | Converts text to full-stack Next.js apps with deployment and ownership.| https://www.co.dev | Next.js, Supabase (PostgreSQL) | Text to app, components/styling/functionality, package install, domain setup, CRUD | Next.js, Supabase | Not specified | Rapid community growth (40K+ builders), production-ready in minutes | Not for complex apps, web only, review for security/scaling | 7.0 | 8.0 | Not specified | -| AIder | Coding tool, Agentic framework | AI pair programming tool for terminal-based collaboration with LLMs. | https://aider.chat | Python, DeepSeek, Claude 3.7 Sonnet, o3-mini | Pair programming, start/work on projects, supports multiple LLMs | Not specified | Not specified | AI-assisted terminal coding, multi-LLM support | Not specified | 5.0 | 3.0 | Not specified | -| Tabnine | Coding tool, Agentic framework, IDE | Contextually aware AI platform for speeding up development with air-gapped deployments. | https://www.tabnine.com | Popular languages/libraries/IDEs | Context-aware suggestions, bespoke models, AI agents for review/testing/docs | Not specified | Atlassian Jira | Gartner #1, 11% productivity boost, custom suggestions | Potential latency issues | 8.0 | 9.0 | Not specified | -| Bubble | Design/frontend, Coding tool, Database/backend, Vibe coding | Full-stack no-code app builder with visual editing and backend. | https://bubble.io | Not specified | Visual app builder, databases, workflows, integrations, hosting | Stripe, Google, various APIs | Not specified | Easy no-code, full-stack, trusted for MVPs | Performance for large apps, lock-in | 8.5 | 8.7 | Free tier, paid from $25/month | -| Supabase | Database/backend | Postgres development platform with database, auth, APIs, and more. | https://supabase.com | ReactJS, NextJS, RedwoodJS, Flutter, Kotlin, SvelteKit, SolidJS, Vue, NuxtJS, Refine | Postgres database, Auth, APIs, Edge Functions, Realtime, Storage, Vector embeddings | Not specified | Not specified | Trusted by Mozilla/GitHub/1Password, quick build/scale | Not specified | 8.0 | 9.0 | Not specified | -| Firebase | Design/frontend, Coding tool, Agentic framework, Database/backend | Platform for app development with AI-powered experiences. | https://firebase.google.com | iOS, Android, Web, Flutter, Unity, C++ | Build AI experiences, managed infra, launch/monitor/iterate, Gemini integration | Gemini, Google Cloud | Not specified | Google-backed, trusted by NPR/Duolingo, millions of users | Not specified | 9.0 | 9.0 | Not specified | -| Appwrite | Coding tool, Database/backend, Agentic framework | Open-source backend platform with auth, databases, and hosting. | https://appwrite.io | 13 languages for serverless functions | Auth, scalable databases, secure storage, serverless, messaging, Realtime, hosting | All Appwrite products (Auth, Databases, Storage, etc.) | Not specified | Loved by Apple/Oracle/TikTok/IBM, wide product range, global scaling | Not specified | 8.0 | 8.0 | Free: $0, Pro: $15/month, Scale: $599/month, Enterprise: custom | -| Nhost | Database/backend | Managed, extensible backend platform for speed, flexibility, and scale. | https://nhost.io | SDKs (specific not detailed) | Scales with user, CI/CD, observability, CLI/dashboard, global deployment, auth SDKs | Not specified | Not specified | Rapid dev, case studies (400K+ users in 6 weeks), reduces onboarding | Not specified | 7.0 | 7.0 | Free tier | -| UI Bakery | Design/frontend, Coding tool, Agentic framework | Low-code platform for building custom internal tools, portals, dashboards. | https://uibakery.io | JavaScript, Python, SQL | Drag-and-drop UI, 30+ integrations, code/no-code logic, Git, one-click deployment | 18+ databases, 17+ services/APIs, REST/OpenAPI/GraphQL | Not specified | Rapid dev, high customization, G2 4.9/5 | Not specified | 8.0 | 8.0 | See https://uibakery.io/pricing | -| Pocketbase | Database/backend, Coding tool | Open-source backend in 1 file with database, auth, storage, and dashboard. | https://pocketbase.io | JavaScript (SDK) | Realtime database, auth, file storage, admin dashboard, CRUD operations | Not specified | Not specified | Ready to use, integrates with frontend stacks | Not specified | 5.0 | 5.0 | Not specified | -| Backendless | Design/frontend, Coding tool, Agentic framework, IDE, Database/backend | Platform for scalable apps with AI-driven automation. | https://backendless.com | Not specified | Build scalable apps, automate workflows, no-code/low-code, flexible hosting | Not specified | Not specified | Flexible backend, intuitive interface, quick POC | Not specified | 7.0 | 6.0 | Cloud/Pro/Managed plans | -| Northflank | Design/frontend, Coding tool, Agentic framework, IDE, Database/backend | Cloud platform for deploying any project from first user to billions. | https://northflank.com | Any language/framework, GitHub/GitLab/Bitbucket, Kubernetes (EKS/GKE/AKS) | UI/CLI/APIs/GitOps, runs on AWS/GCP/Azure/Oracle, templates, secure code, vectorDBs | GitHub, GitLab, Bitbucket | Not specified | Trusted by 2,000+ startups/enterprises, scales to 3M users | Not specified | 8.0 | 8.0 | CPU $0.01667/hr, Memory $0.00833/hr, NVIDIA H100 $2.74/hr, etc. | -| Vercel | Design/frontend, Coding tool, Agentic framework, Database/backend | Developer tools and cloud infra for faster, personalized web. | https://vercel.com | Not specified | Build/deploy on AI Cloud, Git deploys, collaborative previews, AI Gateway, rollbacks | Not specified | Not specified | 95% page load reduction, globally performant, collaborative | Not specified | 8.0 | 8.0 | Not specified | -| Netlify | Design/frontend, Coding tool, Agentic framework | Platform for deploying modern frontend stacks with AI apps. | https://netlify.com | Not specified | Optimized builds, collaborative previews, instant rollbacks, global edge, serverless | Not specified | Not specified | 35M+ projects, 7M+ developers, 99.99% uptime | Not specified | 9.0 | 9.0 | Not specified | -| Render | Coding tool, Database/backend | Cloud platform for building, deploying, scaling apps. | https://render.com | Node.js, Python, Ruby, Docker | Web services/static sites/cron jobs, auto deploys, datastores, autoscaling, IaC | Slack | Not specified | 3M+ developers, 100B requests/month, enterprise-grade | Not specified | 8.0 | 9.0 | Not specified | -| Platform.sh | Database/backend, Coding tool | Self-service PaaS for efficient, reliable, secure infrastructure. | https://platform.sh | 100+ frameworks, 14 languages | Automated infra, Git workflows, multicloud/multistack, scalability, Observability Suite | Not specified | Not specified | 5,000+ customers (Adobe/Economist), 219% ROI, G2 leader | Not specified | 8.0 | 8.0 | Not specified | -| Figma | Design/frontend, Vibe coding | Collaborative interface design tool for design/development teams. | https://figma.com | Not specified | Create/refine products, mockups, design to code, design systems, collaboration | Not specified | Not specified | Trusted by AirBnb/Asana/Atlassian/GitHub, seamless collaboration | Not specified | 8.0 | 9.0 | Not specified | -| Balsamiq | Design/frontend | Wireframing tool for quick, low-fidelity wireframes to align teams. | https://balsamiq.com | Not specified | Drag-and-drop UI, share via links/exports, low-fidelity design, templates | Not specified | Not specified | Reduces rework, aligns teams, easy to use | Lacks advanced features | 8.0 | 8.0 | Not specified | -| LangChain | Coding tool, Agentic framework | Open-source framework for building AI agents with LLMs. | https://www.langchain.com | Python, JavaScript | Agent building, LLM integrations, chaining prompts/tools, memory, RAG | OpenAI, Anthropic, various databases | Hugging Face, Pinecone | Flexible for agentic AI, widely used, community support | Learning curve, debugging agents | 8.5 | 9.0 | Not specified | -| CrewAI | Agentic framework, Coding tool | Framework for orchestrating role-playing autonomous AI agents. | https://crewai.com | Python | Role-based agents, task delegation, multi-agent workflows, LLM integration | OpenAI, Anthropic | Not specified | Easy multi-agent setup, good for automation, community | Limited to Python, agent reliability varies | 7.5 | 8.0 | Not specified | -| AutoGen | Agentic framework, Coding tool | Microsoft's framework for building multi-agent AI systems. | https://microsoft.github.io/autogen/ | Python | Multi-agent orchestration, event-driven architecture, API integration | Microsoft Azure, OpenAI | Not specified | Strong for enterprise, good docs, Semantic Kernel integration | Requires setup for advanced use | 8.0 | 8.0 | Not specified | -| Codeium | Coding tool, IDE | AI code completion tool with suggestions, chat, and search in IDEs. | https://codeium.com | 70+ languages | Autocomplete, chat for code, search codebase, enterprise self-host | VS Code, JetBrains, Neovim | Not specified | Free for individuals, fast, privacy-focused | Less context-aware than Copilot for some | 8.0 | 8.5 | Not specified | -| Amazon CodeWhisperer | Coding tool, IDE | AI coding companion with AWS integration for code suggestions. | https://aws.amazon.com/codewhisperer/ | 15+ languages | Code suggestions, security scans, reference tracker, AWS-specific code | AWS, VS Code, JetBrains | Not specified | Free for individuals, good for cloud devs, security focus | Biased towards AWS, less versatile | 8.0 | 7.5 | Not specified | -| Zed | IDE, Coding tool | High-performance, collaborative code editor with AI integrations. | https://zed.dev | Rust-based, multiple languages | AI autocomplete, collaboration, high speed, Git integration | GitHub Copilot, OpenAI | Not specified | Fastest editor, multiplayer editing, modern UI | Newer, less plugins than VS Code | 7.0 | 7.0 | Not specified | -| Stripe | Payment platform | Payment processing platform for online payments and financial services. | https://stripe.com | JavaScript, Python, Ruby, etc. | Payments, billing, fraud prevention, global support, APIs | Many e-commerce platforms, Next.js, Shopify | Supabase, Vercel, Bubble | Developer-friendly APIs, reliable, scales for enterprises | Fees per transaction, compliance requirements | 9.5 | 9.7 | Not specified | -| Plaid | Payment platform | Connects bank accounts for payments, verification, and financial data. | https://plaid.com | SDKs for various languages | Bank connections, transactions, identity verification, payments | Stripe, Venmo, many fintech apps | Not specified | Secure bank links, wide coverage, easy integration | US-focused, privacy concerns | 9.0 | 8.5 | Not specified | -| Uizard | Design/frontend, Vibe coding | AI-powered UI design tool for rapid prototyping from prompts/sketches. | https://uizard.io | Exports to React, Figma | AI UI generation, prototyping, collaboration, export code | Figma, Adobe XD | Not specified | Fast from prompt to UI, focused on design | Limited to UI, not full code | 7.0 | 7.5 | Not specified | -| Locofy.ai | Design/frontend, Coding tool | Converts Figma/Adobe XD designs to code automatically. | https://www.locofy.ai | React, HTML/CSS, Gatsby | Design to code conversion, component export, responsive code | Figma, Adobe XD | Not specified | Saves time on frontend coding, accurate conversions | Best for simple designs, may need tweaks | 6.5 | 7.0 | Not specified - -| Blackbox | Coding tool, Agentic framework, IDE | AI-powered coding assistant for code generation, autocompletion, and debugging. | https://www.blackbox.ai | Python, JavaScript, TypeScript, Go, C, C++, Java, C# | Code generation, autocompletion, debugging, Figma to code, image to web app, voice interaction | VS Code, GitHub | Not specified | Trusted by 10M+ users, supports 70+ languages, Figma/image to code | May require manual code review, limited offline use | 8.0 | 8.5 | Free, Free Trial, Free Version |[](https://www.blackbox.ai/)[](https://slashdot.org/software/comparison/BLACKBOX-AI-vs-CodeGeeX-vs-GitHub-Copilot/) -| PSEUDO.AI | Coding tool, Vibe coding | AI-powered platform for generating pseudocode from natural language prompts. | https://pseudo.ai | Not specified | Pseudocode generation, natural language to pseudocode, algorithm visualization | Not specified | Not specified | Simplifies algorithm design, beginner-friendly | Limited to pseudocode, not executable code | 6.0 | 5.0 | Not specified | -| Build AI | Design/frontend, Coding tool, Vibe coding | No-code platform for building AI-powered apps and websites via natural language. | https://www.buildai.space | Not specified | App/website builder, natural language interface, AI-driven design, hosting | Not specified | Not specified | User-friendly for non-coders, rapid prototyping | Limited customization for complex apps | 6.5 | 6.0 | Not specified | -| CodeGeeX | Coding tool, IDE | Multilingual code generation model with 13B parameters for 20+ languages. | https://codegeex.cn | C, C++, Go, Java, JavaScript, Python, C#, Angular | Code generation, translation, explanation, summarization, VS Code extension | VS Code | Not specified | Supports 20+ languages, few-shot learning, style customization | Limited to code generation, less contextual awareness | 7.5 | 7.8 | Free, Free Trial, Free Version |[](https://slashdot.org/software/comparison/BLACKBOX-AI-vs-CodeGeeX-vs-GitHub-Copilot/) -| HeyBoss | Design/frontend, Coding tool, Vibe coding, Database/backend | No-code AI builder for websites/apps in minutes, with built-in CRM, SEO, payments. | https://heyboss.ai | Not specified | Website/app builder, CRM, SEO, payment integration, custom internal tools, real-time analytics | OpenAI, Stripe, databases | Not specified | Builds in 5-9 minutes, no coding needed, full-stack automation | Limited for complex logic, potential platform lock-in | 7.8 | 8.2 | Subscription plans, see https://heyboss.ai |[](https://heyboss.ai/)[](https://heyboss.ai/about-heyboss)[](https://nextaitool.com/b/build-a-website-or-app-without-coding-using-heyboss-ai) -| Manus AI | Coding tool, Agentic framework | AI-driven platform for generating and managing code for software projects. | https://manus.im | Not specified | Code generation, project management, automation of coding tasks | Not specified | Not specified | Streamlines project workflows, good for small teams | Limited public info, may lack advanced integrations | 5.5 | 5.0 | Not specified | \ No newline at end of file diff --git a/attached_assets/Codingtools_1754841204573.pdf b/attached_assets/Codingtools_1754841204573.pdf deleted file mode 100644 index d3e142f..0000000 Binary files a/attached_assets/Codingtools_1754841204573.pdf and /dev/null differ diff --git a/attached_assets/DEVELOPMENT_1756933184252.md b/attached_assets/DEVELOPMENT_1756933184252.md deleted file mode 100644 index cb1034c..0000000 --- a/attached_assets/DEVELOPMENT_1756933184252.md +++ /dev/null @@ -1,71 +0,0 @@ -# Development Setup - -## Prerequisites -- Node.js (v16 or higher) -- npm or yarn - -## Installation - -1. Clone the repository: -```bash -git clone -cd AltStackFast -``` - -2. Install dependencies: -```bash -npm install -``` - -## Development - -Start the development server: -```bash -npm run dev -``` - -The application will be available at `http://localhost:5173` - -## Build - -Build for production: -```bash -npm run build -``` - -Preview the production build: -```bash -npm run preview -``` - -## Project Structure - -``` -AltStackFast/ -├── src/ -│ ├── App.jsx # Main application component -│ ├── Main.jsx # Application entry point -│ └── index.css # Global styles with Tailwind -├── index.html # HTML template -├── package.json # Dependencies and scripts -├── vite.config.js # Vite configuration -├── tailwind.config.js # Tailwind CSS configuration -├── postcss.config.js # PostCSS configuration -└── .gitignore # Git ignore rules -``` - -## Technologies Used - -- **React 18** - UI framework -- **Vite** - Build tool and dev server -- **Tailwind CSS** - Utility-first CSS framework -- **Firebase** - Backend services (Firestore, Auth) -- **Marked** - Markdown parsing - -## Security Notes - -The project currently has some moderate security vulnerabilities in development dependencies. These are primarily related to: -- Firebase SDK dependencies -- Development server (esbuild) - -These vulnerabilities don't affect production builds and are being addressed by the respective package maintainers. \ No newline at end of file diff --git a/attached_assets/INTEGRATION_PLAN_1756933135787.md b/attached_assets/INTEGRATION_PLAN_1756933135787.md deleted file mode 100644 index 582bb56..0000000 --- a/attached_assets/INTEGRATION_PLAN_1756933135787.md +++ /dev/null @@ -1,134 +0,0 @@ -# StackFast + TechStack Explorer Integration Plan - -## Phase 1: Data Model Alignment (Week 1) - -### Tool Profile Unification -- Merge StackFast's tool schema with TechStack Explorer's tool model -- Key mappings: - ``` - StackFast → TechStack Explorer - tool_id → id - category[] → categories (junction table) - notable_strengths → features[] - known_limitations → (new field to add) - output_types[] → (new field to add) - integrations[] → integrations[] - maturity_score → maturityScore - ``` - -### Database Strategy -- Use PostgreSQL as primary store (TechStack Explorer) -- Sync with Firestore for StackFast compatibility -- Worker enrichment writes to both databases - -## Phase 2: API Integration (Week 1-2) - -### Unified Endpoints -```javascript -// Combined API structure -/api/v1/ - /tools // List all tools (merged data) - /tools/:id // Tool details + compatibility scores - /compatibility/:a/:b // Compatibility score between tools - /blueprint // Generate blueprint with compatibility awareness - /stack/analyze // Validate stack with harmony scoring - /stack/recommend // AI-powered recommendations -``` - -### Implementation Priority -1. ✅ Compatibility scoring already working (87.5% ChatGPT+Lovable) -2. 🔄 Merge tool schemas -3. 🔄 Integrate blueprint generation -4. 🔄 Connect worker enrichment - -## Phase 3: Frontend Unification (Week 2) - -### UI Components to Merge -- StackFast's tool grid → Enhanced with compatibility badges -- TechStack Explorer's matrix → Integrated into tool details -- Blueprint generator → Include compatibility warnings -- Stack builder → Show harmony scores during selection - -### New Features from Merger -1. **Smart Blueprint Generation**: Automatically select compatible tools -2. **Compatibility-Aware Search**: Filter tools by compatibility with existing stack -3. **Migration Paths**: Show upgrade paths between tools -4. **Real-time Validation**: Check compatibility as users build - -## Phase 4: Advanced Features (Week 3) - -### Intelligence Layer -- Combine StackFast's LLM blueprint generation with compatibility scoring -- Use compatibility data to improve blueprint quality -- Generate migration guides between tech stacks - -### Data Pipeline -``` -GitHub/npm/ProductHunt → Worker → Enrichment → Validation → - ↓ -PostgreSQL (relationships) + Firestore (profiles) - ↓ -API → Frontend + External Consumers -``` - -## Technical Considerations - -### Challenges to Address -1. **Schema Migration**: Need to map StackFast's Zod schemas to Drizzle ORM -2. **Monorepo Structure**: Decide between keeping monorepo or current structure -3. **Authentication**: StackFast has admin routes, need to integrate -4. **Worker Integration**: Connect StackFast's scraping worker to PostgreSQL - -### Immediate Quick Wins -1. Import StackFast's mock tools into current database -2. Add StackFast's tool categories to existing category system -3. Expose compatibility API for StackFast frontend to consume -4. Share validation schemas between projects - -## Recommended Next Steps - -### Option A: Full Integration (Recommended) -1. Move StackFast packages into current project -2. Merge schemas and create unified data model -3. Combine API endpoints -4. Create unified frontend with all features - -### Option B: API Federation -1. Keep projects separate -2. TechStack Explorer exposes compatibility API -3. StackFast consumes compatibility data -4. Share tool registry via API - -### Option C: Modular Approach -1. Extract compatibility engine as npm package -2. StackFast imports and uses compatibility scoring -3. Share tool data via common database -4. Gradual UI integration - -## Value Proposition - -The merged platform would offer: -- **For Developers**: Complete tool selection with compatibility insights -- **For Teams**: Validated tech stack blueprints with harmony scoring -- **For Enterprises**: Data-driven tool adoption decisions -- **For StackFast**: Enhanced with relationship intelligence -- **For TechStack Explorer**: Production-ready architecture and tool registry - -## Compatibility Examples Working Today -- ChatGPT + Lovable: 87.5/100 (High AI synergy) -- GitHub Copilot + Windsurf: 92.3/100 (Excellent compatibility) -- Supabase + Bubble: 73.2/100 (Moderate integration) - -## Migration Effort Estimate -- **Data Migration**: 2-3 days -- **API Integration**: 3-4 days -- **Frontend Merge**: 4-5 days -- **Testing & Refinement**: 2-3 days -- **Total**: ~2 weeks for full integration - -## Success Metrics -- Unified tool database with 50+ tools -- Compatibility scores for all tool pairs -- Blueprint generation with compatibility awareness -- 90%+ stack validation accuracy -- Sub-second API response times \ No newline at end of file diff --git a/attached_assets/PHASE2_COMPLETE_1756933135787.md b/attached_assets/PHASE2_COMPLETE_1756933135787.md deleted file mode 100644 index 7cf5a2e..0000000 --- a/attached_assets/PHASE2_COMPLETE_1756933135787.md +++ /dev/null @@ -1,117 +0,0 @@ -# Phase 2 Complete: StackFast API Integration ✅ - -## Major Achievement: Blueprint Generation with Compatibility Intelligence - -Successfully integrated StackFast's blueprint generation with TechStack Explorer's compatibility matrix, creating a unique value proposition that neither project had alone. - -## What's Working Now - -### 1. Enhanced Blueprint Generation -```bash -POST /api/v1/blueprint -{ - "rawIdea": "Build a real-time collaborative code editor with AI assistance", - "preferredTools": ["Replit"], - "timeline": "mvp", - "budget": "medium" -} -``` - -Returns: -- **Intelligent Tech Stack**: Automatically selects tools with high compatibility -- **Stack Analysis**: Harmony score (59%), no conflicts, medium integration complexity -- **Tool Recommendations**: Each tool includes compatibility score with others -- **Timeline Estimates**: Development, testing, deployment phases adjusted by complexity -- **Cost Estimates**: Monthly tooling, infrastructure, and maintenance costs - -### 2. Tool Recommendations by Idea -```bash -POST /api/v1/tools/recommend -{ - "idea": "AI-powered web application with real-time features", - "maxResults": 5 -} -``` - -Returns top tools categorized by need: -- Frontend & Design: v0 (7.8/10) -- AI Coding Assistants: ChatGPT (9.7/10), GitHub Copilot (9.3/10) -- Based on idea parsing and category matching - -### 3. Compatibility Reports for Stacks -```bash -POST /api/v1/stack/compatibility-report -{ - "tools": ["Replit", "ChatGPT", "Supabase"] -} -``` - -Returns: -- Overall Harmony: 58% -- Compatibility Matrix: All pairwise scores -- Recommendations: Integration guidance -- Summary: High/low compatibility pair counts - -## Technical Implementation - -### New Services Created -1. **stackfast-adapter.ts**: Bridges StackFast schemas with our database -2. **blueprint-generator.ts**: Intelligent blueprint creation with compatibility awareness - -### Key Features -- **Compatibility-Aware Selection**: Tools selected based on mutual compatibility scores -- **Alternative Stack Generation**: Suggests better combinations when harmony is low -- **Integration Complexity Assessment**: Estimates effort based on tool relationships -- **Smart Categorization**: Analyzes project ideas to determine needed tool categories - -## Real-World Examples - -### Example 1: SaaS Platform -- **Input**: "Build a SaaS platform for project management with AI features" -- **Selected Stack**: v0 + ChatGPT -- **Harmony Score**: 59% -- **Integration**: Medium complexity -- **Timeline**: 6-8 weeks for MVP - -### Example 2: Tech Stack Analysis -- **Stack**: Replit + ChatGPT + Supabase -- **Overall Harmony**: 58% -- **Best Pair**: Replit + Supabase (61.9%) -- **Challenging Pair**: Replit + ChatGPT (54.9%) -- **Recommendation**: Standard integration effort expected - -## Integration Benefits Realized - -### Before Integration -- StackFast: Blueprint generation without compatibility awareness -- TechStack Explorer: Compatibility scores without blueprint context - -### After Integration -- **Unified Intelligence**: Blueprints consider tool relationships -- **Reduced Risk**: Warns about low-compatibility combinations -- **Better Recommendations**: Tools selected for both functionality AND compatibility -- **Cost Awareness**: Estimates based on actual tool pricing -- **Timeline Accuracy**: Adjusted by integration complexity - -## Database Statistics -- **11 Tools**: Mix of StackFast and original tools -- **55 Compatibility Relationships**: All tools interconnected -- **3 New API Endpoints**: Fully operational -- **Response Times**: 1-2 seconds average - -## Next Steps: Phase 3 - UI Integration - -With the API layer complete, the foundation is ready for: -1. Unified frontend combining both UIs -2. Visual blueprint builder with compatibility warnings -3. Interactive stack analyzer with real-time scoring -4. Migration wizard for tool transitions - -## Success Metrics -- ✅ All planned API endpoints operational -- ✅ Compatibility scores influence recommendations -- ✅ Blueprint generation considers tool relationships -- ✅ Real-time analysis with < 2s response times -- ✅ No conflicts between systems - -The merger has successfully created a **Tech Stack Intelligence Platform** that provides data-driven recommendations with compatibility awareness - a unique offering in the market! \ No newline at end of file diff --git a/attached_assets/PHASE3_PROGRESS_1756933135788.md b/attached_assets/PHASE3_PROGRESS_1756933135788.md deleted file mode 100644 index 50d8be3..0000000 --- a/attached_assets/PHASE3_PROGRESS_1756933135788.md +++ /dev/null @@ -1,68 +0,0 @@ -# Phase 3 Progress: Frontend Unification - -## Completed Components - -### 1. Blueprint Builder Page -- Full-featured blueprint generation interface at `/blueprint` -- Supports project idea input, tool preferences, timeline, and budget -- Shows comprehensive blueprint with: - - Tech stack recommendations with compatibility scores - - Frontend and backend logic breakdown - - Timeline estimates (development, testing, deployment) - - Cost estimates (tooling, infrastructure, maintenance) - - Alternative stacks with harmony scores - -### 2. Stack Harmony Component -- Unified compatibility visualization (`stack-harmony.tsx`) -- Displays: - - Overall harmony score with visual progress bar - - Tool-by-tool compatibility breakdown - - Integration difficulty indicators - - Conflicts and warnings alerts - - Success messages for high-compatibility stacks - -### 3. Quick Blueprint Widget -- Integrated into dashboard for immediate access -- One-line project idea input -- Instant blueprint generation with harmony scores -- Preview of recommended tech stack -- Direct link to full blueprint view - -### 4. Navigation Updates -- Added Blueprint Builder to main navigation -- Icon-based navigation with Sparkles icon -- Seamless integration with existing tabs - -## Integration Features Working - -### API Endpoints Fully Operational -1. `/api/v1/blueprint` - Generates AI-powered blueprints -2. `/api/v1/tools/recommend` - Tool recommendations by idea -3. `/api/v1/stack/compatibility-report` - Detailed compatibility analysis - -### Data Flow -- Blueprint generation considers compatibility scores -- Tool recommendations based on harmony with existing selections -- Real-time compatibility calculations -- Integration complexity assessment - -## UI/UX Improvements -- Consistent GitHub-inspired dark theme -- Neon orange accent for key actions -- Mobile-responsive design -- Loading states and error handling -- Toast notifications for user feedback - -## Database Statistics -- 11 tools integrated (StackFast + original) -- 55 compatibility relationships -- Categories properly mapped -- Response times < 2 seconds - -## Next Steps for Full Completion -1. Enhanced tool registry view combining both systems -2. Visual compatibility matrix with heat map -3. Migration wizard UI for tool transitions -4. Export functionality for blueprints - -The frontend unification has successfully created a cohesive user experience that merges StackFast's blueprint generation with TechStack Explorer's compatibility intelligence! \ No newline at end of file diff --git a/attached_assets/PHASE4_COMPLETE_1756933135789.md b/attached_assets/PHASE4_COMPLETE_1756933135789.md deleted file mode 100644 index 38ef3e5..0000000 --- a/attached_assets/PHASE4_COMPLETE_1756933135789.md +++ /dev/null @@ -1,124 +0,0 @@ -# Phase 4: Complete Platform Integration - SUCCESS ✓ - -## Completed: January 16, 2025 - -### What We Built -Phase 4 completes the full merger between TechStack Explorer and StackFast with advanced visualization and migration capabilities: - -## New Features Implemented - -### 1. Visual Compatibility Heatmap -- **Interactive Matrix Visualization**: Color-coded heatmap showing compatibility scores between tools -- **Smart Color Gradient**: Green (excellent) → Yellow (moderate) → Red (poor) compatibility -- **Hover Details**: Tooltip showing exact scores and tool pairs -- **Toggle Labels**: Show/hide score numbers for cleaner visualization -- **Performance Optimized**: Displays top 12 tools to avoid UI overload - -### 2. Migration Wizard -- **Step-by-Step Migration Planning**: Intelligent 9-step migration process from one tool to another -- **Difficulty Assessment**: Automatic classification (easy/medium/hard) based on compatibility -- **Time Estimates**: - - Easy: 3-7 days - - Medium: 7-14 days - - Hard: 14-30 days -- **Risk Analysis**: Identifies potential issues and migration challenges -- **Benefits Tracking**: Highlights advantages of migrating to new tools -- **Export Functionality**: Download migration plans as JSON for offline use -- **Progress Tracking**: Visual step completion with checkmarks and navigation - -### 3. Migration API Endpoint -```javascript -GET /api/v1/migration/:fromTool/:toTool -``` -Returns comprehensive migration analysis including: -- Data portability percentage (how much data can be transferred) -- Feature parity score (feature compatibility between tools) -- Detailed migration steps -- Cost implications and budget estimates -- Risk assessment with mitigation strategies - -### 4. Enhanced UI Integration -- **4-Tab Layout**: Matrix View | Heatmap | Migration | Insights -- **Seamless Navigation**: All views integrated into Compatibility Matrix page -- **Responsive Design**: Mobile-optimized components -- **Dark Theme**: Consistent GitHub-inspired styling - -## Technical Achievements - -### Backend Enhancements -- Added `getToolByName` method to storage interface -- Migration path generation algorithm considers: - - Tool compatibility scores - - Category relationships - - Feature overlap - - Integration complexity -- Dynamic risk/benefit analysis based on compatibility - -### Frontend Components -- `CompatibilityHeatmap`: Reusable matrix visualization component -- `MigrationWizard`: Full-featured migration planning interface -- Proper TypeScript typing throughout -- TanStack Query integration for data fetching - -## Migration Intelligence Examples - -### Easy Migration (80+ compatibility) -**Cursor IDE → VS Code**: 3-7 days -- High feature parity (95%) -- Minimal workflow disruption -- Smooth transition guaranteed - -### Medium Migration (60-80 compatibility) -**ChatGPT → Claude**: 7-14 days -- Some feature differences -- Team training required -- Moderate integration work - -### Hard Migration (<60 compatibility) -**Bubble → React**: 14-30 days -- Significant platform differences -- Custom transformation scripts needed -- Extended downtime possible - -## Platform Integration Complete - -### Unified Feature Set -✓ Tool Database with 51+ tools -✓ Compatibility Matrix with smart scoring -✓ Blueprint Generation with harmony analysis -✓ Stack Builder with validation -✓ Migration Wizard for tool transitions -✓ Visual Heatmap for quick insights -✓ Analytics and insights dashboard -✓ External data source management -✓ API endpoints for all features - -### Value Delivered -- **For Developers**: Complete migration planning with risk assessment -- **For Teams**: Visual compatibility insights for tech decisions -- **For Enterprises**: Data-driven tool adoption with cost analysis -- **For Projects**: Smooth tool transitions with minimal disruption - -## Success Metrics Achieved -- ✅ 51 tools with full compatibility data -- ✅ 4 major UI views integrated -- ✅ Migration planning < 2 second response time -- ✅ Export functionality for offline planning -- ✅ 100% feature coverage from both platforms - -## Next Steps (Future Enhancements) -1. AI-powered migration script generation -2. Real-time migration progress tracking -3. Community-contributed migration templates -4. Integration with CI/CD pipelines -5. Automated compatibility testing - -## Summary -Phase 4 successfully completes the merger between TechStack Explorer and StackFast. The platform now offers a comprehensive suite of tools for: -- Discovering and comparing development tools -- Analyzing compatibility between technologies -- Planning and executing tool migrations -- Generating optimized tech stack blueprints -- Visualizing complex tool relationships - -The merger is complete with all planned features operational! 🎉 \ No newline at end of file diff --git a/attached_assets/Readme_1756933135789.md b/attached_assets/Readme_1756933135789.md deleted file mode 100644 index 48b837c..0000000 --- a/attached_assets/Readme_1756933135789.md +++ /dev/null @@ -1,210 +0,0 @@ -# TechStack Explorer - AI Tool Compatibility Matrix - -## Overview -TechStack Explorer is a compatibility matrix database module for the StackFast platform. It provides an interactive system to analyze relationships between development tools, forming the data foundation for tech stack recommendations. Key capabilities include a dynamic tool database fed by external sources, compatibility scoring, comparison functionality, analytics for AI coding tools, and real-time API integration for data updates. The project aims to enhance StackFast's ability to recommend optimal tech stacks based on tool interoperability. - -## User Preferences -Preferred communication style: Simple, everyday language. - -## System Architecture - -### Core Design -- **Purpose**: Interactive compatibility matrix for tech stack recommendations. -- **Data Source Prioritization**: Emphasizes curated external sources (Back4App, Product Hunt) over raw GitHub data for higher quality tool identification. -- **Intelligent Tool Identification**: Filters out non-tool entries (programming languages, book collections, resource lists) to ensure the matrix contains actual development tools. -- **Compatibility Generation**: Automates compatibility scoring based on tool metadata, category-based rules, and known tool relationships. -- **Scalability**: Designed to handle thousands of tools with optimized performance for compatibility matrix generation. - -### Frontend -- **Framework**: React 18 with TypeScript. -- **Routing**: Wouter. -- **UI Library**: Radix UI components with shadcn/ui styling. -- **Styling**: Tailwind CSS with CSS variables, featuring a neon orange accent and GitHub-inspired dark theme. -- **State Management**: TanStack Query for server state management and caching. -- **Build Tool**: Vite. -- **Responsive Design**: Mobile-first approach. -- **User Interface**: Features a dashboard homepage displaying statistics, categories, and popular tools; a Stack Builder for stack validation and harmony scoring; a Compare Tools section; and a Tool Database with advanced search and external data source management. The compatibility matrix operates primarily in the background to power recommendations. - -### Backend -- **Runtime**: Node.js with Express.js. -- **Language**: TypeScript with ESM modules. -- **API Design**: RESTful API with structured route handlers. -- **Data Layer**: Abstracted storage interface, with Drizzle ORM for PostgreSQL. -- **API Integration System**: Modular service with provider-specific adapters (GitHub, npm, Docker Hub, OpenAI, Stripe, Vercel) for dynamic tool discovery and data mapping. -- **External Data Sources System**: Service for importing tools from Back4App, GitHub, npm, and Product Hunt, including features for batch import, dry run, and automatic categorization. - -### Database -- **ORM**: Drizzle ORM with PostgreSQL dialect. -- **Schema**: `toolCategories`, `tools`, and `compatibilities` tables. `tool_category_junction` table for many-to-many relationships between tools and categories. -- **Data Types**: JSONB fields for flexible array storage. -- **Migrations**: Managed through Drizzle Kit. - -### API Endpoints -- `/api/v1/compatibility/:toolA/:toolB`: Get compatibility score. -- `/api/v1/stack/analyze`: Analyze complete stack with harmony scoring. -- `/api/v1/tools/search`: Search tools with filters. -- `/api/v1/recommendations`: AI-powered recommendations. -- `/api/v1/categories`: Get all categories with tool counts. -- `/api/v1/migration/:fromTool/:toTool`: Get migration paths between tools. - -## External Dependencies - -### Core Frameworks -- React Ecosystem (React 18, React DOM) -- TypeScript -- Vite -- Express - -### Database & ORM -- Drizzle ORM -- @neondatabase/serverless (for Neon PostgreSQL) -- connect-pg-simple - -### UI & Design System -- Radix UI -- Tailwind CSS -- shadcn/ui -- class-variance-authority -- Lucide React - -### State Management & Data Fetching -- TanStack Query -- React Hook Form -- @hookform/resolvers - -### Development & Build Tools -- tsx -- esbuild -- PostCSS -- @replit/vite-plugin-runtime-error-modal - -### Utility Libraries -- clsx & tailwind-merge -- date-fns -- wouter -- zod -- csv-parse - -## Recent Changes - -### January 17, 2025 - Platform Complete with 71 Tools -- **Successfully reached all 5 success metrics**: - - 71 tools in database (exceeding 50+ requirement by 42%) - - 114 compatibility relationships with intelligent scoring - - Blueprint generation fully operational with TypeScript fixes - - Sub-second API response times (0.497s average) - - Stack validation with harmony scoring working perfectly - -- **Fixed critical dashboard issues**: - - Dashboard now correctly displays actual tool counts from database - - Updated category statistics to match database category names - - Fixed TypeScript errors in dashboard components - - Compatibility scores showing correct count (114) - -- **Database fully populated**: - - Added 15 additional tools (Continue, Codeshot, Dify, Pieces, Sourcery, Railway, Coolify, Plasmic, Builder.io, Retool, Appsmith, Directus, Strapi, Hygraph, Convex) - - All tools have proper categorization and metadata - - Comprehensive compatibility matrix with real-world relationships - -### January 16, 2025 - Code Review & Bug Fixes Complete -- **Fixed Critical API Issues**: - - Stack analysis endpoint now accepts both `toolIds` and `toolNames` parameters - - Tool recommendations API returning proper results (was empty before) - - Migration endpoint working correctly with tool name lookups - -- **Implemented Missing Features**: - - Created AddToolDialog component for adding new tools to database - - Integrated dialog with main app, replacing TODO placeholder - - Full form validation and category selection working - - Successfully creates tools with all required fields - -- **Code Quality Improvements**: - - Fixed all TypeScript type errors - - No LSP diagnostics remaining - - Properly integrated with TanStack Query for state management - - All API endpoints tested and verified working - -### January 15, 2025 - StackFast Integration Phase 2 Complete -- **Enhanced Blueprint Generation with Compatibility Awareness**: - - Created integration services: stackfast-adapter.ts and blueprint-generator.ts - - Blueprint generation now considers tool compatibility scores for optimal recommendations - - Stack analysis includes harmony scores, conflict detection, and integration complexity assessment - - Alternative stack suggestions when compatibility is low - -- **New API Endpoints Operational**: - - `/api/v1/blueprint` - Generate AI-powered blueprints with compatibility insights - - `/api/v1/tools/recommend` - Get tool recommendations based on project ideas - - `/api/v1/stack/compatibility-report` - Detailed compatibility analysis for tech stacks - - All endpoints return structured data with actionable recommendations - -- **Integration Value Delivered**: - - Blueprints now include: tech stack harmony (58-92%), integration difficulty, timeline estimates - - Tool recommendations consider compatibility with already selected tools - - Real-world example: "Real-time collaborative editor" gets v0 + ChatGPT with 59% harmony score - - Cost estimates and alternative stacks provided when needed - -### January 15, 2025 - StackFast Integration Quick Win -- **Successfully Merged StackFast Tools**: - - Imported 5 tools from StackFast: Replit, Cursor IDE, Bolt.new, v0, Claude Artifacts - - Generated 55 intelligent compatibility relationships (52 new, 3 updated) - - Expanded database from 6 to 11 tools (83% growth) - -- **Cross-Platform Compatibility Insights**: - - Cursor IDE + GitHub Copilot: 62.5/100 (good AI tool synergy) - - Bolt.new + Supabase: 59.9/100 (moderate full-stack compatibility) - - Replit + ChatGPT: 54.9/100 (complementary development tools) - - Stack analysis showing 58% harmony for Replit+ChatGPT+Supabase - -- **Integration Value Demonstrated**: - - StackFast tools now have compatibility scores with existing tools - - API endpoints fully operational for cross-platform queries - - Intelligent scoring based on categories, languages, frameworks, features - - Created integration plan for full merger (INTEGRATION_PLAN.md) - -## Recent Changes - -### January 11, 2025 - Intelligent Compatibility Matrix Engine Operational -- **Built Core Compatibility Intelligence**: - - Created CompatibilityEngine that calculates smart compatibility scores (0-100) based on: - - Category relationships (AI tools work well together) - - Shared frameworks/languages (React, TypeScript, JavaScript) - - Common integrations and mutual support - - Complementary vs competing feature sets - - Maturity alignment between tools - -- **Live Compatibility Data**: - - ChatGPT + Lovable: 87.5/100 (high AI tool synergy, easy integration) - - GitHub Copilot + Windsurf: 92.3/100 (very high dev tool compatibility) - - Supabase + Bubble: 73.2/100 (moderate backend/frontend complementarity) - - v1 API endpoints return detailed integration steps, dependencies, difficulty levels - -- **Advanced Stack Analysis**: - - Stack validation with harmony scoring working - - Integration difficulty assessment (easy/medium/hard) - - Dependency analysis and setup step generation - - Verified vs theoretical integrations tracking - -- **Resolved Data Diversity Issues**: - - Fixed identical scoring problem (all tools showing 8.0/10) - - Tools now display authentic, diverse data: ChatGPT (9.5/9.8), GitHub Copilot (9.0/9.5), etc. - - Database populated with 6 tools across 7 categories - - Dashboard and Tool Database show realistic, varied pricing and scoring - -### January 10, 2025 - Complete Category System Overhaul -- **Restructured Category System**: - - Created hierarchical category structure with 7 main categories and 15 subcategories - - Main categories: Development Environments, AI Coding Assistants, No-Code/Low-Code, Backend & Infrastructure, Frontend & Design, Specialized Tools, Payment & Commerce - - Implemented proper multi-category assignment based on tool functionality - - Fixed incorrect categorizations (e.g., Cursor now properly categorized as IDE + AI assistant, not just Design) - -- **Tool Recategorization**: - - Migrated all 51 tools to new category structure using CSV data - - Tools now properly distributed across relevant categories (e.g., Replit in IDE + Vibe Coding + Hosting) - - Each tool has a primary category (categoryId) plus additional categories via junction table - - Average of 2-3 categories per tool for better discovery - -- **UI Updates**: - - Dashboard: Popular tools show multiple category badges - - Stack Builder: Tools appear under ALL their categories (no more missing tools) - - Compare Tools: Dropdown and comparison cards display multiple categories - - Tool Database: Already showing multiple categories correctly \ No newline at end of file diff --git a/attached_assets/Readme_1756933184253.md b/attached_assets/Readme_1756933184253.md deleted file mode 100644 index fd4bb3e..0000000 --- a/attached_assets/Readme_1756933184253.md +++ /dev/null @@ -1,158 +0,0 @@ -# Stackfast · Workflow Architect for AI Development - -Build fast, and build right. Stackfast turns product ideas into actionable, tool‑aware build plans and keeps a living, validated registry of AI development tools. - -Live links: - -- **Frontend**: [stackfast.vercel.app](https://stackfast.vercel.app) -- **API**: [stackfast-api.vercel.app](https://stackfast-api.vercel.app) - ---- - -## ✨ Highlights - -- **Blueprints from plain English**: Structured, validated JSON plans with backend/frontend steps and workflow stages. -- **Trusted tool registry**: Curated profiles with Zod validation, provenance, and freshness goals. -- **Reliable by design**: Server‑side LLM, strict schemas, timeouts/retries, rate limiting, CORS/Helmet, and ETags. - ---- - -## 🧱 Architecture - -- **Frontend** (`packages/app`, Vite + React) - - Calls the API only (no client LLM keys) - - Tools grid and details, blueprint generator UI - -- **API** (`packages/api`, Express) - - `GET /v1/tools` → validated tool profiles (ETagged) - - `POST /v1/blueprint` → strictly validated JSON blueprint - - Security: CORS allowlist, Helmet, rate limits, `/healthz` + `/readyz` - -- **Worker** (`packages/worker`) - - GitHub changes → scrape site with Playwright → Gemini → Zod validate → Firestore - -- **Schemas** (`packages/schemas`) - - Shared Zod models; emits `toolProfile.schema.json` during build - -Monorepo layout: - -```text -Stackfast/ - packages/ - app/ # Vite + React UI - api/ # Express API (serverless on Vercel) - worker/ # RAG enrichment worker (containerized) - schemas/ # Shared Zod types; emits JSON schema - src/ # Legacy prototype (kept for reference) -``` - ---- - -## 🚀 Quick start (local) - -Requirements: **Node 20+**, npm (or pnpm/yarn) - -Install deps (from repo root): - -```bash -npm install -``` - -Run frontend: - -```bash -npm run dev --workspace=@stackfast/app -``` - -Run API: - -```bash -npm run dev --workspace=@stackfast/api -``` - -Run Worker (optional for ingestion/RAG): - -```bash -npm run dev --workspace=@stackfast/worker -``` - ---- - -## 🔐 Environment - -See `env.example` for the latest list. Key variables: - -| Area | Variable | Description | -| --- | --- | --- | -| API | `GEMINI_API_KEY` | Google Generative Language API key (required) | -| API | `GEMINI_MODEL` | Gemini model name, default `gemini-1.5-flash` | -| API | `FRONTEND_ORIGIN` or `FRONTEND_ORIGINS` | Comma‑separated CORS allowlist | -| API/Worker | `GOOGLE_APPLICATION_CREDENTIALS` | Service account JSON (raw or base64) | -| Worker | `GITHUB_TOKEN` | Optional, raises GitHub API rate limits | -| Worker | `WORKER_PORT` | Local worker port, default `8080` | -| API | `WORKER_URL` | Direct worker fallback URL, default `http://localhost:8080/analyze` | -| API | `TOOLS_SOURCE` | `firestore` (prod) or `mock` (local) | - -Optional (queueing): `QSTASH_URL`, `QSTASH_TOKEN`. - -Frontend: `VITE_API_URL` (e.g., `https://stackfast-api.vercel.app`). - ---- - -## 📚 API reference (essentials) - -- **GET** `/v1/tools` - - Response: `{ success: true, data: ToolProfile[], count, timestamp }` - -- **POST** `/v1/blueprint` - - Body: `{ rawIdea: string, stackRegistry?: any }` - - Returns strictly validated JSON blueprint - -- **Health**: `GET /healthz` → `ok`, `GET /readyz` → `{ ok, firestore }` - ---- - -## 🧪 Quality & CI - -- Lint (warnings fail CI): - -```bash -npm run lint -``` - -- Tests: - -```bash -npm run test -``` - -- Build all: - -```bash -npm run build -``` - -GitHub Actions (`.github/workflows/ci.yml`) runs install → lint → build → tests on Node 20. - ---- - -## 🗺️ Roadmap (high‑signal) - -- **Catalog**: Firestore as source of truth, faceted search, details pages with deep links. -- **Ingestion (Worker)**: Scheduling, provenance, robust retries/backoff, human‑in‑the‑loop review. -- **Blueprints**: Streaming UI, saved/sharable plans, small template library. -- **Contracts**: Publish OpenAPI + JSON Schema; read‑only public API with rate limits; MCP parity. -- **Ops**: Sentry (FE+API), structured logs, dashboards, clear runbooks. - ---- - -## 🤝 Contributing - -- Open an issue with “feature” or “bug” -- PRs welcome—keep edits focused and typed - ---- - -## 📝 License - -MIT (see `LICENSE` if present) diff --git a/attached_assets/Realm101furtrans.png b/attached_assets/Realm101furtrans.png deleted file mode 100644 index efa88e3..0000000 Binary files a/attached_assets/Realm101furtrans.png and /dev/null differ diff --git a/attached_assets/STACKFAST_MERGER_SUCCESS_1756933135790.md b/attached_assets/STACKFAST_MERGER_SUCCESS_1756933135790.md deleted file mode 100644 index da07f2e..0000000 --- a/attached_assets/STACKFAST_MERGER_SUCCESS_1756933135790.md +++ /dev/null @@ -1,109 +0,0 @@ -# 🎉 StackFast + TechStack Explorer Merger Success - -## Quick Win Implementation Complete! - -Successfully imported **5 StackFast tools** and generated **55 intelligent compatibility relationships**. The merger demonstrates immediate value through cross-platform compatibility insights. - -## New Tools Added from StackFast - -| Tool | Category | Maturity | Popularity | Key Features | -|------|----------|----------|------------|--------------| -| **Replit** | Development Environments | 9.0 | 8.5 | Instant dev environment, Ghostwriter AI | -| **Cursor IDE** | AI Coding Assistants | 8.0 | 7.5 | Advanced AI chat, Codebase understanding | -| **Bolt.new** | No-Code/Low-Code | 7.0 | 7.8 | Instant deployment, AI generation | -| **v0** | Frontend & Design | 7.5 | 8.0 | Component generation, Tailwind CSS | -| **Claude Artifacts** | AI Coding Assistants | 8.5 | 9.0 | Real-time execution, Multi-language | - -## Intelligent Compatibility Scores Generated - -### High Compatibility Pairs (>60%) -- **Cursor IDE + GitHub Copilot**: 62.5/100 - - Both AI coding assistants - - Shared language support - - Complementary features - -### Moderate Compatibility (50-60%) -- **Bolt.new + Supabase**: 59.9/100 - - Full-stack development synergy - - JavaScript/TypeScript overlap - - Integration potential - -- **Replit + ChatGPT**: 54.9/100 - - Development + AI assistance - - Common programming languages - - Different but complementary use cases - -- **v0 + Claude Artifacts**: 54.2/100 - - UI generation meets code execution - - React/TypeScript commonality - -## Stack Analysis Example - -**Modern AI Development Stack** (Replit + ChatGPT + Supabase): -- Overall Harmony: 58% -- No conflicts detected -- Integration difficulty: Mixed (easy to hard) -- Full-stack capability achieved - -## Value Demonstrated - -### Before Merger -- StackFast: Tool profiles without relationships -- TechStack Explorer: Limited tool database (6 tools) - -### After Merger -- **11 total tools** with rich metadata -- **55 compatibility relationships** calculated -- **Intelligent scoring** based on: - - Category synergies - - Framework overlaps - - Language commonalities - - Integration capabilities - - Feature complementarity - -## API Integration Working - -```bash -# Get compatibility between any two tools -GET /api/v1/compatibility/Replit/ChatGPT -# Returns: 54.9/100 with integration guidance - -# Analyze complete tech stacks -POST /api/v1/stack/analyze -# Body: {"toolIds": ["id1", "id2", "id3"]} -# Returns: Harmony score, conflicts, recommendations -``` - -## Next Steps for Full Integration - -1. **Phase 1 Complete** ✅ - - Tools imported - - Compatibility generated - - API endpoints working - -2. **Phase 2: Enhanced Integration** (Next) - - Connect StackFast's blueprint generator - - Use compatibility scores in recommendations - - Merge UI components - -3. **Phase 3: Unified Platform** - - Single frontend with all features - - Worker enrichment pipeline - - Production deployment - -## Technical Achievement - -- **Zero conflicts**: Tools integrated seamlessly -- **Intelligent scoring**: Not default 50/100 values -- **Real relationships**: Based on actual tool characteristics -- **Production ready**: API returns structured, validated data - -## Conclusion - -The quick win proves the merger's value. With just 30 minutes of work: -- Expanded tool database by 83% (6 → 11 tools) -- Generated 55 new compatibility insights -- Demonstrated cross-platform synergies -- Validated the integration approach - -The combined platform now offers **complete tool intelligence** that neither project had alone! \ No newline at end of file diff --git a/attached_assets/Stackfast.png b/attached_assets/Stackfast.png deleted file mode 100644 index 18beb7f..0000000 Binary files a/attached_assets/Stackfast.png and /dev/null differ diff --git a/attached_assets/Stackstudio.png b/attached_assets/Stackstudio.png deleted file mode 100644 index 5c49f8c..0000000 Binary files a/attached_assets/Stackstudio.png and /dev/null differ diff --git a/attached_assets/TWP.png b/attached_assets/TWP.png deleted file mode 100644 index 79628e2..0000000 Binary files a/attached_assets/TWP.png and /dev/null differ diff --git a/attached_assets/WEEK1_IMPLEMENTATION_1756933184254.md b/attached_assets/WEEK1_IMPLEMENTATION_1756933184254.md deleted file mode 100644 index 2dedf07..0000000 --- a/attached_assets/WEEK1_IMPLEMENTATION_1756933184254.md +++ /dev/null @@ -1,196 +0,0 @@ -# Week 1 Implementation: MCP Server Foundation - -This document outlines the Week 1 implementation of the AltStackFast MCP server, providing the foundational code and structure for the backend API. - -## 🏗️ Architecture Overview - -``` -AltStackFast/ -├── toolProfile.schema.json # Central JSON schema -├── src/ -│ ├── schemas/ -│ │ └── toolProfile.ts # Zod validation schema -│ └── api/ -│ ├── server.ts # Express server setup -│ └── routes/ -│ └── tools.ts # Tools API endpoints -├── tsconfig.server.json # TypeScript config for server -└── env.example # Environment variables template -``` - -## 📋 What's Implemented - -### 1. Central Schema (`toolProfile.schema.json`) -- **Single source of truth** for tool profile data structure -- JSON Schema Draft-07 compliant -- Defines all required and optional fields -- Used for generating TypeScript types and validation - -### 2. Zod Schema (`src/schemas/toolProfile.ts`) -- **Type-safe validation** using Zod -- Generated from the JSON schema -- Provides TypeScript types via `z.infer` -- Ensures data integrity before database operations - -### 3. Express API Server (`src/api/server.ts`) -- **Production-ready setup** with CORS, JSON parsing -- Firestore integration (ready for Week 2) -- Health check endpoint for deployment platforms -- Environment variable configuration - -### 4. Tools API Routes (`src/api/routes/tools.ts`) -- **GET /v1/tools** - List all tools with validation -- **GET /v1/tools/:toolId** - Get specific tool by ID -- Mock data for Week 1 development -- Comprehensive error handling -- Structured JSON responses - -## 🚀 Getting Started - -### 1. Install Dependencies -```bash -npm install -``` - -### 2. Set Up Environment -```bash -cp env.example .env -# Edit .env with your configuration -``` - -### 3. Start Development Server -```bash -npm run server:dev -``` - -The server will start on `http://localhost:8080` - -## 📡 API Endpoints - -### Health Check -```bash -GET /healthz -``` -Returns: `200 OK` with "ok" message - -### Root Endpoint -```bash -GET / -``` -Returns server information and available endpoints - -### List All Tools -```bash -GET /v1/tools -``` -Returns: -```json -{ - "success": true, - "data": [...], - "count": 3, - "timestamp": "2025-08-04T..." -} -``` - -### Get Specific Tool -```bash -GET /v1/tools/replit -``` -Returns: -```json -{ - "success": true, - "data": { - "tool_id": "replit", - "name": "Replit", - ... - } -} -``` - -## 🔧 Development Commands - -```bash -# Start development server with hot reload -npm run server:dev - -# Build for production -npm run server:build - -# Start production server -npm run server:start -``` - -## 🧪 Testing the API - -### Using curl -```bash -# Health check -curl http://localhost:8080/healthz - -# Get all tools -curl http://localhost:8080/v1/tools - -# Get specific tool -curl http://localhost:8080/v1/tools/replit -``` - -### Using the frontend -The existing React frontend can now connect to this API instead of using mock data. - -## 📊 Mock Data - -Week 1 includes mock data for three tools: -- **Replit** - Browser-based IDE -- **Cursor IDE** - AI-first code editor -- **Bolt.new** - AI-powered web app builder - -Each tool includes all required fields and demonstrates the schema structure. - -## 🔒 Validation - -All API responses are validated against the Zod schema before being sent. This ensures: -- Data integrity -- Type safety -- Consistent API responses -- Early error detection - -## 🚧 Next Steps (Week 2) - -1. **Firestore Integration**: Replace mock data with real Firestore queries -2. **Job Queue Setup**: Implement BullMQ with Upstash Redis -3. **Worker Service**: Create background job processing -4. **Error Handling**: Add comprehensive error logging and monitoring - -## 🔍 Code Quality Features - -- **TypeScript**: Full type safety for the backend -- **ESLint**: Code quality and consistency -- **Structured Logging**: Console output with timestamps -- **Error Boundaries**: Graceful error handling -- **CORS**: Cross-origin request support -- **Environment Configuration**: Flexible deployment setup - -## 📝 Notes - -- The server uses ES modules (`import/export`) -- Firestore is initialized but not yet used (Week 2) -- All endpoints return structured JSON responses -- Error responses include helpful messages -- The schema version is set to "2025-08-04" for tracking - -## 🐛 Troubleshooting - -### Common Issues - -1. **Port already in use**: Change `PORT` in `.env` -2. **TypeScript errors**: Run `npm run server:build` to check for issues -3. **Firestore connection**: Ensure `GOOGLE_APPLICATION_CREDENTIALS` is set correctly - -### Debug Mode -```bash -DEBUG=* npm run server:dev -``` - -This implementation provides a solid foundation for the MCP server and follows the Week 1 roadmap outlined in the main README. \ No newline at end of file diff --git a/attached_assets/WEEK2_IMPLEMENTATION_1756933184254.md b/attached_assets/WEEK2_IMPLEMENTATION_1756933184254.md deleted file mode 100644 index da6ecc5..0000000 --- a/attached_assets/WEEK2_IMPLEMENTATION_1756933184254.md +++ /dev/null @@ -1,228 +0,0 @@ -# Week 2 Implementation: Job Queue & Worker PoC - -This document outlines the Week 2 implementation of the AltStackFast job queue system, providing the foundation for background job processing. - -## 🏗️ Architecture Overview - -``` -AltStackFast/ -├── src/ -│ ├── api/ -│ │ ├── server.ts # Express server with queue integration -│ │ ├── queue.ts # BullMQ queue configuration -│ │ └── routes/ -│ │ ├── tools.ts # Tools API endpoints -│ │ └── analyze.ts # Analysis job endpoints -│ └── worker/ -│ └── worker.ts # Background job processor -├── tsconfig.server.json # TypeScript config for server -├── tsconfig.worker.json # TypeScript config for worker -└── package.json # Updated with BullMQ dependencies -``` - -## 📋 What's Implemented - -### 1. BullMQ Queue System (`src/api/queue.ts`) -- **Redis connection** with Upstash support -- **Job queue** with retry logic and exponential backoff -- **Priority handling** (low, normal, high) -- **Health monitoring** and job status tracking -- **Type-safe job data** and result interfaces - -### 2. Analysis API (`src/api/routes/analyze.ts`) -- **POST /v1/analyze** - Add analysis jobs to queue -- **GET /v1/analyze/:jobId** - Get job status and results -- **Request validation** using Zod schemas -- **Comprehensive error handling** - -### 3. Background Worker (`src/worker/worker.ts`) -- **Job processor** with configurable concurrency -- **Progress tracking** and real-time updates -- **Graceful shutdown** handling -- **Mock analysis simulation** for Week 2 PoC -- **Event logging** and error reporting - -### 4. Enhanced Server (`src/api/server.ts`) -- **Queue health endpoint** (`/queue/health`) -- **Integrated analyze routes** -- **Enhanced logging** and status reporting - -## 🚀 Getting Started - -### 1. Install Dependencies -```bash -npm install -``` - -### 2. Start the API Server -```bash -npm run server:dev -``` - -### 3. Start the Worker (in a separate terminal) -```bash -npm run worker:dev -``` - -## 📡 API Endpoints - -### Queue Health Check -```bash -GET /queue/health -``` -Returns queue statistics and health status - -### Add Analysis Job -```bash -POST /v1/analyze -Content-Type: application/json - -{ - "toolId": "replit", - "url": "https://replit.com", - "description": "Browser-based IDE", - "priority": "normal" -} -``` - -### Get Job Status -```bash -GET /v1/analyze/{jobId} -``` -Returns job status, progress, and results - -## 🔧 Development Commands - -```bash -# Start API server with hot reload -npm run server:dev - -# Start worker with hot reload -npm run worker:dev - -# Build for production -npm run server:build -npm run worker:build - -# Start production services -npm run server:start -npm run worker:start -``` - -## 🧪 Testing the Job Queue - -### 1. Add a Job -```bash -curl -X POST http://localhost:8080/v1/analyze \ - -H "Content-Type: application/json" \ - -d '{ - "toolId": "replit", - "url": "https://replit.com", - "priority": "high" - }' -``` - -### 2. Check Job Status -```bash -# Replace {jobId} with the ID from step 1 -curl http://localhost:8080/v1/analyze/{jobId} -``` - -### 3. Monitor Queue Health -```bash -curl http://localhost:8080/queue/health -``` - -## 📊 Job Processing Features - -### Priority Levels -- **High Priority**: Processed in ~1 second -- **Normal Priority**: Processed in ~3 seconds -- **Low Priority**: Processed in ~5 seconds - -### Progress Tracking -Jobs report progress from 0-100% during processing - -### Error Handling -- **Automatic retries** with exponential backoff -- **Failure simulation** for low-priority jobs (10% chance) -- **Graceful error reporting** - -### Concurrency -- **5 simultaneous jobs** processed by default -- **Configurable** via worker settings - -## 🔍 Monitoring & Observability - -### Queue Health -```json -{ - "status": "healthy", - "stats": { - "waiting": 2, - "active": 1, - "completed": 15, - "failed": 0 - }, - "timestamp": "2025-08-04T..." -} -``` - -### Job Status -```json -{ - "jobId": "123", - "status": "completed", - "progress": 100, - "result": { - "toolId": "replit", - "analysis": { - "strengths": [...], - "limitations": [...], - "useCases": [...], - "maturityScore": 0.85 - } - } -} -``` - -## 🚧 Next Steps (Week 3) - -1. **Real AI Analysis**: Replace mock analysis with Gemini API calls -2. **Web Scraping**: Add Playwright for tool website analysis -3. **Firestore Integration**: Store analysis results in database -4. **Advanced Error Handling**: Add comprehensive logging and monitoring - -## 🔍 Code Quality Features - -- **TypeScript**: Full type safety for jobs and results -- **Zod Validation**: Request/response validation -- **Error Boundaries**: Comprehensive error handling -- **Graceful Shutdown**: Proper cleanup on termination -- **Progress Tracking**: Real-time job progress updates -- **Priority Queuing**: Intelligent job prioritization - -## 📝 Notes - -- Uses **Upstash Redis** for production-ready queue -- **Mock analysis** for Week 2 PoC (real AI in Week 3) -- **Concurrent processing** with configurable limits -- **Automatic retries** with exponential backoff -- **Health monitoring** for both queue and worker - -## 🐛 Troubleshooting - -### Common Issues - -1. **Redis connection failed**: Check `UPSTASH_REDIS_REST_URL` in `.env.local` -2. **Worker not processing**: Ensure worker is running with `npm run worker:dev` -3. **Jobs stuck**: Check queue health endpoint for stalled jobs -4. **Memory issues**: Reduce concurrency in worker settings - -### Debug Mode -```bash -# Enable debug logging -DEBUG=bullmq:* npm run worker:dev -``` - -This implementation provides a solid foundation for background job processing and sets up the infrastructure for Week 3's AI analysis integration. \ No newline at end of file diff --git a/attached_assets/WEEK3_IMPLEMENTATION_1756933184255.md b/attached_assets/WEEK3_IMPLEMENTATION_1756933184255.md deleted file mode 100644 index 1f984e5..0000000 --- a/attached_assets/WEEK3_IMPLEMENTATION_1756933184255.md +++ /dev/null @@ -1,281 +0,0 @@ -# Week 3 Implementation: AI Analyst v1 with Guardrails - -This document outlines the Week 3 implementation of the AltStackFast AI Analyst system, providing intelligent web scraping and AI-powered analysis with comprehensive guardrails. - -## 🏗️ Architecture Overview - -``` -AltStackFast/ -├── src/ -│ ├── lib/ -│ │ ├── gemini.ts # Gemini API client with guardrails -│ │ └── redis.ts # Redis connection for BullMQ -│ ├── queues/ -│ │ └── analyze.queue.ts # BullMQ queue configuration -│ ├── workers/ -│ │ └── analyze.worker.ts # Intelligent analysis worker -│ ├── api/ -│ │ ├── server.ts # Express server with queue integration -│ │ └── routes/ -│ │ └── analyze.ts # Updated analysis endpoints -│ └── schemas/ -│ └── toolProfile.ts # Zod validation schema -├── tsconfig.worker.json # TypeScript config for worker -└── package.json # Updated with Playwright dependencies -``` - -## 📋 What's Implemented - -### 1. Gemini API Client (`src/lib/gemini.ts`) -- **Structured JSON output** using response schema -- **Low temperature (0.1)** for factual responses -- **Strict prompt template** with guardrails -- **Error handling** and validation -- **Zod schema integration** for type safety - -### 2. Redis Configuration (`src/lib/redis.ts`) -- **BullMQ-compatible** Redis connection -- **Connection monitoring** and error handling -- **Upstash support** for production deployment -- **Graceful shutdown** handling - -### 3. BullMQ Queue System (`src/queues/analyze.queue.ts`) -- **Priority queuing** (low/normal/high) -- **Exponential backoff** retry strategy -- **Job status tracking** and monitoring -- **Queue statistics** and health checks - -### 4. Intelligent Worker (`src/workers/analyze.worker.ts`) -- **Playwright web scraping** for dynamic content -- **AI analysis pipeline** with Gemini API -- **Zod validation** of AI responses -- **Firestore integration** for data storage -- **Progress tracking** and error handling - -### 5. Enhanced API Routes (`src/api/routes/analyze.ts`) -- **Updated request schema** for tool analysis -- **BullMQ integration** for job queuing -- **Comprehensive error handling** -- **Job status monitoring** - -## 🚀 Getting Started - -### 1. Install Dependencies -```bash -npm install -npx playwright install chromium -``` - -### 2. Set Up Environment -Add your Gemini API key to `.env.local`: -```bash -GEMINI_API_KEY=your-actual-gemini-api-key -``` - -Get your API key from: https://makersuite.google.com/app/apikey - -### 3. Start the Services - -#### Start API Server -```bash -npm run server:dev -``` - -#### Start Intelligent Worker (in separate terminal) -```bash -npm run analyze-worker:dev -``` - -## 📡 API Endpoints - -### Add Analysis Job -```bash -POST /v1/analyze -Content-Type: application/json - -{ - "tool_name": "replit", - "url": "https://replit.com", - "priority": "normal" -} -``` - -### Get Job Status -```bash -GET /v1/analyze/{jobId} -``` - -### Queue Health Check -```bash -GET /queue/health -``` - -## 🔧 Development Commands - -```bash -# Start API server with hot reload -npm run server:dev - -# Start intelligent worker with hot reload -npm run analyze-worker:dev - -# Build for production -npm run server:build -npm run analyze-worker:build - -# Start production services -npm run server:start -npm run analyze-worker:start -``` - -## 🧪 Testing the AI Analyst - -### 1. Add an Analysis Job -```bash -curl -X POST http://localhost:8080/v1/analyze \ - -H "Content-Type: application/json" \ - -d '{ - "tool_name": "replit", - "url": "https://replit.com", - "priority": "high" - }' -``` - -### 2. Monitor Job Progress -```bash -# Replace {jobId} with the ID from step 1 -curl http://localhost:8080/v1/analyze/{jobId} -``` - -### 3. Check Queue Health -```bash -curl http://localhost:8080/queue/health -``` - -## 🔍 Analysis Pipeline - -### 1. Web Scraping (Playwright) -- **Headless browser** for JavaScript-heavy sites -- **Dynamic content** extraction -- **Timeout handling** and error recovery -- **Content sanitization** and processing - -### 2. AI Analysis (Gemini API) -- **Structured prompt** with clear instructions -- **JSON schema** enforcement -- **Low temperature** for factual responses -- **Hallucination prevention** guardrails - -### 3. Data Validation (Zod) -- **Schema validation** of AI responses -- **Type safety** enforcement -- **Error handling** for invalid data -- **Automatic correction** where possible - -### 4. Data Storage (Firestore) -- **Structured storage** with validation -- **Version tracking** and timestamps -- **Review flags** for AI-generated content -- **Merge strategy** for updates - -## 🛡️ Guardrails & Safety - -### AI Response Validation -- **Structured JSON** output only -- **Schema enforcement** via Zod -- **Null values** for missing data -- **No hallucination** policy - -### Error Handling -- **Graceful failures** with retries -- **Comprehensive logging** for debugging -- **Timeout protection** for long operations -- **Resource cleanup** on errors - -### Data Quality -- **Content sanitization** before AI analysis -- **Length limits** to prevent token overflow -- **Format validation** at multiple stages -- **Human review** flags for AI content - -## 📊 Monitoring & Observability - -### Job Progress Tracking -```json -{ - "jobId": "analyze_1234567890_abc123", - "status": "active", - "progress": 60, - "result": null, - "timestamp": "2025-08-04T..." -} -``` - -### Queue Statistics -```json -{ - "status": "healthy", - "stats": { - "waiting": 2, - "active": 1, - "completed": 15, - "failed": 0 - }, - "timestamp": "2025-08-04T..." -} -``` - -### Worker Health -- **Process monitoring** and restart capability -- **Memory usage** tracking -- **Concurrency limits** and management -- **Graceful shutdown** handling - -## 🚧 Next Steps (Week 4) - -1. **MCP Endpoint**: Implement `/mcp/v1` endpoint -2. **Authentication**: Add JWT middleware for admin routes -3. **Rate Limiting**: Implement rate limiting on public endpoints -4. **Deployment**: Deploy to Vercel (API) and Fly.io (Worker) -5. **CI/CD**: Set up GitHub Actions for automated testing - -## 🔍 Code Quality Features - -- **TypeScript**: Full type safety throughout -- **Zod Validation**: Request/response validation -- **Error Boundaries**: Comprehensive error handling -- **Progress Tracking**: Real-time job progress updates -- **Resource Management**: Proper cleanup and shutdown -- **Logging**: Structured logging for debugging - -## 📝 Notes - -- **Playwright** requires Chromium browser installation -- **Gemini API** requires API key from Google AI Studio -- **Redis** connection needed for BullMQ (local or Upstash) -- **Firestore** integration for data persistence -- **Concurrent processing** with configurable limits - -## 🐛 Troubleshooting - -### Common Issues - -1. **Playwright browser not found**: Run `npx playwright install chromium` -2. **Gemini API errors**: Check API key and quota limits -3. **Redis connection failed**: Verify Redis configuration -4. **Memory issues**: Reduce concurrency in worker settings -5. **Timeout errors**: Increase timeout values for slow sites - -### Debug Mode -```bash -# Enable debug logging -DEBUG=playwright:* npm run analyze-worker:dev -``` - -### Performance Tuning -- **Concurrency**: Adjust worker concurrency (default: 3) -- **Timeouts**: Modify scraping and API timeouts -- **Memory**: Monitor memory usage and adjust limits -- **Retries**: Configure retry strategies for failures - -This implementation provides a production-ready AI analysis system with comprehensive guardrails and monitoring capabilities. \ No newline at end of file diff --git a/attached_assets/favicon.png b/attached_assets/favicon.png deleted file mode 100644 index 4f9eb90..0000000 Binary files a/attached_assets/favicon.png and /dev/null differ diff --git a/attached_assets/image_1754909171565.png b/attached_assets/image_1754909171565.png deleted file mode 100644 index d79e09f..0000000 Binary files a/attached_assets/image_1754909171565.png and /dev/null differ diff --git a/client/index.html b/client/index.html deleted file mode 100644 index f93065a..0000000 --- a/client/index.html +++ /dev/null @@ -1,21 +0,0 @@ - - - - - - TechStack Explorer - AI Tool Compatibility Matrix - - - - - - - - - -
- - - - - diff --git a/client/src/App.tsx b/client/src/App.tsx deleted file mode 100644 index 567a516..0000000 --- a/client/src/App.tsx +++ /dev/null @@ -1,121 +0,0 @@ -import { Switch, Route } from "wouter"; -import { queryClient } from "./lib/queryClient"; -import { QueryClientProvider } from "@tanstack/react-query"; -import { Toaster } from "@/components/ui/toaster"; -import { TooltipProvider } from "@/components/ui/tooltip"; -import { ThemeProvider } from "@/components/ui/theme-provider"; -import { Header } from "@/components/layout/header"; -import { Sidebar } from "@/components/layout/sidebar"; -import { CommandPalette } from "@/components/command-palette"; -import { AddToolDialog } from "@/components/add-tool-dialog"; -import { useState } from "react"; - -// Pages -import DashboardPage from "@/pages/dashboard"; -import QuickStartPage from "@/pages/quickstart"; -import CompatibilityMatrixPage from "@/pages/compatibility-matrix"; -import ToolDatabasePage from "@/pages/tool-database"; -import ComparePage from "@/pages/compare"; -import MigrationWizard from "@/pages/migration-wizard"; -import { StackBuilder } from "@/pages/stack-builder"; -import AnalyticsPage from "@/pages/analytics"; -import BlueprintBuilder from "@/pages/blueprint-builder"; -import DocumentationPage from "@/pages/documentation"; -import NotFound from "@/pages/not-found"; - -function Router() { - const [commandPaletteOpen, setCommandPaletteOpen] = useState(false); - const [addToolOpen, setAddToolOpen] = useState(false); - - const handleAddTool = () => { - setAddToolOpen(true); - }; - - const handleOpenCommandPalette = () => { - setCommandPaletteOpen(true); - }; - - return ( -
- {/* Sidebar */} - - - {/* Main Content Area */} -
-
- -
- - {/* Main routes */} - - - - - - - - - {/* Tool detail page - to be implemented */} -
-

Tool Details

-
-
- - - - - - - - {/* Help/Support routes */} - - -
-

Help & Support

-

Get help with TechStack Explorer.

-
-
- -
-

Settings

-

Configure your TechStack Explorer experience.

-
-
- - {/* 404 */} - -
-
-
- - {/* Global Modals */} - - -
- ); -} - -function App() { - return ( - - - - - - - - - ); -} - -export default App; diff --git a/client/src/components/add-tool-dialog.tsx b/client/src/components/add-tool-dialog.tsx deleted file mode 100644 index ebeb71c..0000000 --- a/client/src/components/add-tool-dialog.tsx +++ /dev/null @@ -1,232 +0,0 @@ -import { useState } from "react"; -import { Button } from "@/components/ui/button"; -import { - Dialog, - DialogContent, - DialogDescription, - DialogFooter, - DialogHeader, - DialogTitle, -} from "@/components/ui/dialog"; -import { Input } from "@/components/ui/input"; -import { Label } from "@/components/ui/label"; -import { Textarea } from "@/components/ui/textarea"; -import { Select, SelectContent, SelectItem, SelectTrigger, SelectValue } from "@/components/ui/select"; -import { useToast } from "@/hooks/use-toast"; -import { useMutation, useQuery } from "@tanstack/react-query"; -import { apiRequest, queryClient } from "@/lib/queryClient"; -import { Plus } from "lucide-react"; - -interface AddToolDialogProps { - open: boolean; - onOpenChange: (open: boolean) => void; -} - -export function AddToolDialog({ open, onOpenChange }: AddToolDialogProps) { - const { toast } = useToast(); - const [formData, setFormData] = useState({ - name: "", - description: "", - categoryId: "", - url: "", - pricing: "", - notes: "", - popularityScore: 5, - maturityScore: 5, - }); - - const { data: categories = [] } = useQuery({ - queryKey: ["/api/categories"], - }); - - const createTool = useMutation({ - mutationFn: async (data: typeof formData) => { - return apiRequest("/api/tools", "POST", { - ...data, - frameworks: [], - languages: [], - features: [], - integrations: [], - }); - }, - onSuccess: () => { - toast({ - title: "Tool created", - description: "The new tool has been added successfully.", - }); - queryClient.invalidateQueries({ queryKey: ["/api/tools"] }); - queryClient.invalidateQueries({ queryKey: ["/api/tools/quality"] }); - onOpenChange(false); - resetForm(); - }, - onError: () => { - toast({ - title: "Error", - description: "Failed to create tool. Please try again.", - variant: "destructive", - }); - }, - }); - - const resetForm = () => { - setFormData({ - name: "", - description: "", - categoryId: "", - url: "", - pricing: "", - notes: "", - popularityScore: 5, - maturityScore: 5, - }); - }; - - const handleSubmit = (e: React.FormEvent) => { - e.preventDefault(); - if (!formData.name || !formData.description || !formData.categoryId) { - toast({ - title: "Missing fields", - description: "Please fill in all required fields.", - variant: "destructive", - }); - return; - } - createTool.mutate(formData); - }; - - return ( - - -
- - Add New Tool - - Add a new development tool to the database. - - -
-
- - setFormData({ ...formData, name: e.target.value })} - className="col-span-3" - required - /> -
-
- -