Merge pull request #1 from pipedrive/AINATIVEM-41

AINATIVEM-41: CLI tool foundation — create-pipedrive-app scaffold

Author: dmitriyeff

.github/workflows/ci.yml

@@ -0,0 +1,21 @@
+name: CI
+
+on:
+  push:
+    branches: [master]
+  pull_request:
+    branches: [master]
+
+jobs:
+  ci:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+      - uses: actions/setup-node@v4
+        with:
+          node-version: 20
+          cache: npm
+      - run: npm ci
+      - run: npm run lint
+      - run: npm run typecheck
+      - run: npm test

.gitignore

@@ -0,0 +1,7 @@
+node_modules/
+dist/
+.env
+docs/superpowers/
+
+# locally generated test apps
+*-app/

.prettierrc

@@ -0,0 +1,9 @@
+{
+	"printWidth": 120,
+	"singleQuote": true,
+	"useTabs": true,
+	"tabWidth": 4,
+	"trailingComma": "all",
+	"quoteProps": "consistent",
+	"proseWrap": "always"
+}

CLAUDE.md

@@ -0,0 +1,92 @@
+# CLAUDE.md
+
+This file provides guidance to Claude Code (claude.ai/code) when working with code in this repository.
+
+## Project Purpose
+
+`create-pipedrive-app` is a CLI scaffolding tool for external Pipedrive Marketplace developers. It generates a production-ready integration project via `npx create-pipedrive-app <project-name>`.
+
+## Architecture
+
+The tool is **CLI-first**, with an **AI plugin layer** built on top:
+
+- **CLI core**: Collects user choices via interactive prompts, then generates a project scaffold from templates.
+- **AI plugin layer** (secondary): Claude/Codex skills that wrap the CLI — guide developers, modify existing projects, and explain generated code.
+
+### Interactive prompts (CLI)
+
+The CLI asks for:
+- Backend: Node.js/Express, Node.js/Fastify, or PHP/Laravel
+- Database: Postgres, MySQL, or SQLite
+- App Extensions frontend: React, Vanilla JS, or none
+- Webhooks: Yes/No
+
+### Generated project structure
+
+```
+<project-name>/
+  backend/
+    oauth/         # Authorization redirect, callback, token exchange, refresh, state validation
+    pipedrive-client/  # Official API client wrapper with preconfigured auth
+    database/      # Tenant/account mapping, tokens, scopes, installation status
+    webhooks/      # Optional webhook handlers
+  frontend/
+    app-extension-ui/  # Optional: React or Vanilla iframe UI with App Extensions SDK
+  .env.example
+  README.md
+  docker-compose.yml
+  marketplace-checklist.md
+```
+
+## MVP Scope
+
+The initial implementation targets:
+- **Runtime**: Node.js + TypeScript
+- **Backend**: Express or Fastify
+- **Database**: Postgres via Docker Compose
+- **Auth**: Full OAuth 2.0 install/callback/token-refresh flow
+- **API client**: Pipedrive Node.js client wrapper
+- **Frontend** (optional): React App Extensions UI
+- Outputs `.env.example` and a Marketplace readiness checklist
+
+PHP and MySQL/SQLite backends come after MVP.
+
+## Core Modules
+
+### OAuth (`backend/oauth/`)
+Full OAuth 2.0: app registration guidance, authorization redirect, callback handling, token exchange, token refresh, state validation.
+
+### Database (`backend/database/`)
+Uses **Drizzle ORM** (`drizzle-orm` + `drizzle-kit`) for schema definition and migrations. Drizzle is chosen because it supports Postgres, MySQL, and SQLite with the same TypeScript API — matching the three database options the CLI offers — and produces readable schema files with no codegen step.
+
+Structure:
+- `schema.ts` — Drizzle table definitions (tenants, oauth_tokens, installations)
+- `migrations/` — SQL migration files managed by `drizzle-kit`
+- `db.ts` — driver setup (selects `postgres-js`, `mysql2`, or `better-sqlite3` based on the chosen DB)
+
+Key packages: `drizzle-orm`, `drizzle-kit`, and the appropriate driver for the selected database.
+
+### Pipedrive API client (`backend/pipedrive-client/`)
+Wrapper around the official Pipedrive Node.js client with preconfigured authentication and helpers for common API calls.
+
+### App Extensions frontend (`frontend/app-extension-ui/`)
+Only generated when the user opts in. Iframe-based UI using the App Extensions SDK, supporting: initialization, resizing, modals, notifications/snackbars, theme handling.
+
+## Development
+
+To test app generation locally:
+
+```bash
+npx tsx src/cli.ts app
+```
+
+This creates an `app/` directory in the repo root (gitignored via `*-app/`).
+
+## AI Plugin Commands (future layer)
+
+```
+/pipedrive-new-app
+/pipedrive-add-oauth
+/pipedrive-add-app-extension
+/pipedrive-review-marketplace-readiness
+```

eslint.config.js

@@ -0,0 +1,15 @@
+import eslint from '@eslint/js';
+import tseslint from 'typescript-eslint';
+
+export default tseslint.config(
+  eslint.configs.recommended,
+  ...tseslint.configs.recommended,
+  {
+    ignores: ['dist/**'],
+  },
+  {
+    rules: {
+      '@typescript-eslint/no-unused-vars': ['error', { argsIgnorePattern: '^_' }],
+    },
+  },
+);