@polymorphism-tech/morph-spec 4.3.3 → 4.3.4

package/docs/api/styles/prettify.css

@@ -1,80 +0,0 @@
-.pln {
-  color: #ddd;
-}
-
-/* string content */
-.str {
-  color: #61ce3c;
-}
-
-/* a keyword */
-.kwd {
-  color: #fbde2d;
-}
-
-/* a comment */
-.com {
-  color: #aeaeae;
-}
-
-/* a type name */
-.typ {
-  color: #8da6ce;
-}
-
-/* a literal value */
-.lit {
-  color: #fbde2d;
-}
-
-/* punctuation */
-.pun {
-  color: #ddd;
-}
-
-/* lisp open bracket */
-.opn {
-  color: #000000;
-}
-
-/* lisp close bracket */
-.clo {
-  color: #000000;
-}
-
-/* a markup tag name */
-.tag {
-  color: #8da6ce;
-}
-
-/* a markup attribute name */
-.atn {
-  color: #fbde2d;
-}
-
-/* a markup attribute value */
-.atv {
-  color: #ddd;
-}
-
-/* a declaration */
-.dec {
-  color: #EF5050;
-}
-
-/* a variable name */
-.var {
-  color: #c82829;
-}
-
-/* a function name */
-.fun {
-  color: #4271ae;
-}
-
-/* Specify class=linenums on a pre to get line numbering */
-ol.linenums {
-  margin-top: 0;
-  margin-bottom: 0;
-  padding-bottom: 2px;
-}

package/docs/cli-auto-detection.md

@@ -1,219 +0,0 @@
-# CLI Auto Context Detection
-
-The MORPH-SPEC CLI now includes intelligent auto-detection that analyzes your project and automatically generates accurate configuration files.
-
-## Features
-
-- **🤖 LLM-Powered Analysis**: Uses Claude Code's embedded LLM to analyze your project
-- **📊 Multi-Stack Support**: Detects Next.js, Blazor, .NET APIs, monorepos, and more
-- **🔒 Privacy-First**: All data stays local (no external API calls)
-- **🎯 90%+ Accuracy**: Few-shot learning with real project examples
-- **🛡️ Secret Sanitization**: Automatically redacts API keys, passwords, and sensitive data
-- **🧙 Fallback Wizard**: Manual 7-question wizard if auto-detection fails
-
-## Usage
-
-### New Projects
-
-```bash
-# Initialize MORPH with auto-detection
-morph-spec init
-
-# Skip auto-detection (manual config later)
-morph-spec init --skip-detection
-
-# Force wizard mode (skip LLM)
-morph-spec init --wizard
-```
-
-### Existing Projects
-
-```bash
-# Re-analyze and update configs
-morph-spec update
-
-# Skip auto-detection during update
-morph-spec update --skip-detection
-
-# Force wizard mode
-morph-spec update --wizard
-```
-
-## How It Works
-
-### 1. Project Scanning
-
-Scans your project for:
-- `package.json` (dependencies, scripts)
-- `.csproj` and `.sln` files
-- `README.md` and `CLAUDE.md`
-- Directory structure (src/, frontend/, backend/, etc.)
-- Infrastructure files (Dockerfile, *.bicep, CI/CD pipelines)
-- Git remote URL
-
-### 2. Context Sanitization
-
-Removes sensitive data before LLM analysis:
-- **Whitelisted files**: Only reads safe files (package.json, README, etc.)
-- **Blacklisted directories**: Never scans node_modules/, .git/, bin/, obj/
-- **Secret redaction**: Removes API keys, passwords, connection strings
-- **File truncation**: Limits README/CLAUDE.md to first 500 chars
-
-### 3. LLM Analysis
-
-Uses Claude Code's LLM with few-shot learning:
-- 3 example projects (Next.js, Blazor, Monorepo)
-- Structured JSON output
-- Schema validation with Ajv
-- Confidence scoring (0-100%)
-
-### 4. User Review
-
-Interactive preview with options:
-- ✅ **Approve** - Save configs as-is
-- ✏️ **Edit** - Open in $EDITOR before saving
-- ❌ **Cancel** - Abort without changes
-
-Shows diff if updating existing configs.
-
-### 5. Fallback to Wizard
-
-If LLM fails (no Claude Code, timeout, invalid response):
-- Automatically launches 7-question interactive wizard
-- Asks: name, description, type, frontend, backend, database, infrastructure
-- Generates valid config from manual input
-
-## Requirements
-
-- **Claude Code CLI**: Auto-detection requires Claude Code environment
-- **Node.js 18+**: For running the CLI
-- **Git (optional)**: For remote URL detection
-
-## Configuration Files Generated
-
-### `.morph/project.md`
-
-Human-readable project overview:
-- Stack summary table
-- Architecture pattern
-- Code conventions
-- Infrastructure (Azure, Docker, CI/CD)
-- LLM confidence score
-- Warnings (if any)
-
-### `.morph/config/config.json`
-
-Machine-readable config for agents:
-- Project name, type, description
-- Stack (frontend, backend, database, hosting)
-- Architecture pattern
-- Infrastructure flags
-- Generated metadata (timestamp, confidence)
-
-## Supported Project Types
-
-| Type | Detection Criteria | Example |
-|------|-------------------|---------|
-| `nextjs` | package.json has `next` dependency | Next.js app |
-| `blazor-server` | .csproj with Blazor.Server | Blazor Server app |
-| `dotnet-api` | .csproj without Blazor | .NET Web API |
-| `cli-tool` | package.json with `bin` field | CLI tool |
-| `monorepo` | frontend/ and backend/ directories | Full-stack monorepo |
-| `other` | Fallback for unknown projects | Custom setups |
-
-## Troubleshooting
-
-### "Claude Code environment not detected"
-
-Auto-detection requires Claude Code CLI. Options:
-1. Run `morph-spec init --wizard` for manual configuration
-2. Install Claude Code and retry
-3. Use `--skip-detection` to configure later
-
-### "LLM analysis timeout"
-
-Default timeout is 60 seconds for interactive use. If analysis takes too long:
-1. Reduce project size (clean node_modules, dist)
-2. Use `--wizard` for manual configuration
-3. Check Claude Code performance
-
-### "Schema validation failed"
-
-LLM returned invalid JSON. Possible causes:
-- Project structure too complex
-- Missing critical files (no package.json or .csproj)
-- Solution: Use `--wizard` mode
-
-### Configs overwriting customizations
-
-Auto-detection creates backups:
-- `.morph/project.md.YYYY-MM-DDTHH-MM-SS.backup`
-- `.morph/config/config.json.YYYY-MM-DDTHH-MM-SS.backup`
-
-Review diffs before approving updates.
-
-## Edge Cases
-
-| Edge Case | Behavior |
-|-----------|----------|
-| Empty project (no files) | Falls back to wizard |
-| Large project (1000+ files) | Only whitelisted files read |
-| Monorepo with multiple stacks | Detects all stacks, shows in config |
-| No database detected | `stack.database` set to `null` |
-| No frontend detected | `stack.frontend` set to `null` |
-| Git repo without remote | `gitRemote` set to `null` |
-| User cancels (Ctrl+C) | Clean exit, no files modified |
-
-## Privacy & Security
-
-✅ **Local-only processing**: LLM runs in Claude Code (no external API calls)
-✅ **Secret redaction**: 10+ secret patterns detected and removed
-✅ **Whitelist-only reads**: Only safe files are analyzed
-✅ **No telemetry**: No data sent to Anthropic or third parties
-
-## Examples
-
-### Example 1: Next.js + Supabase
-
-**Detected:**
-```json
-{
-  "name": "my-nextjs-app",
-  "type": "nextjs",
-  "stack": {
-    "frontend": { "tech": "Next.js", "version": "15" },
-    "backend": { "tech": "Supabase", "version": "latest" },
-    "database": { "tech": "PostgreSQL", "version": "16" }
-  },
-  "confidence": 95
-}
-```
-
-### Example 2: Blazor + Azure SQL
-
-**Detected:**
-```json
-{
-  "name": "MyApp",
-  "type": "blazor-server",
-  "stack": {
-    "frontend": { "tech": "Blazor", "version": "10" },
-    "backend": { "tech": ".NET", "version": "10" },
-    "database": { "tech": "Azure SQL", "version": "latest" }
-  },
-  "hasAzure": true,
-  "confidence": 98
-}
-```
-
-## Command Flags
-
-| Flag | Description |
-|------|-------------|
-| `--skip-detection` | Skip auto-detection (manual config) |
-| `--wizard` | Force interactive wizard mode |
-| `--force` | Overwrite existing configs without prompt |
-
----
-
-For more help, see the [Troubleshooting Guide](./troubleshooting.md).

package/docs/getting-started.md

@@ -1,296 +0,0 @@
-# Getting Started - MORPH-SPEC
-
-**M**ethodical **O**rchestration for **R**eliable **P**roduction-ready **SPEC**-driven development
-
-> by Polymorphism Tech
-
----
-
-## Quick Start (5 minutos)
-
-### 1. Copiar para seu projeto
-
-```bash
-# Clone o framework
-git clone https://github.com/polymorphism-tech/morph-framework.git
-
-# Copie o conteúdo para seu projeto
-cp -r morph-framework/stacks/blazor-azure/.morph /seu/projeto/
-cp -r morph-framework/stacks/blazor-azure/.claude /seu/projeto/
-cp morph-framework/stacks/blazor-azure/CLAUDE.md /seu/projeto/
-```
-
-### 2. Configurar
-
-```bash
-cd /seu/projeto/.morph/config
-cp config.template.json config.json
-```
-
-Edite `config.json`:
-```json
-{
-  "project": {
-    "name": "Seu Projeto",
-    "stack": "blazor"
-  },
-  "azure": {
-    "subscriptionId": "sua-subscription",
-    "resourceGroup": "rg-seuprojeto-dev"
-  }
-}
-```
-
-### 3. Usar com Claude Code
-
-Abra seu projeto no Claude Code e use os slash commands:
-
-```
-/morph-proposal minha-feature
-```
-
-O MORPH vai guiar você pelas 5 fases automaticamente.
-
----
-
-## Estrutura Completa
-
-```
-seu-projeto/
-├── CLAUDE.md                          # Instruções para o AI
-│
-├── .morph/
-│   ├── project.md                     # Contexto do projeto
-│   ├── config/
-│   │   ├── config.json                # Sua configuração
-│   │   └── agents.json                # Definição dos agentes
-│   │
-│   ├── standards/
-│   │   ├── coding.md                  # Padrões de código
-│   │   ├── architecture.md            # Padrões de arquitetura
-│   │   └── azure.md                   # Padrões Azure/IaC
-│   │
-│   ├── templates/
-│   │   ├── spec.md                    # Template de especificação
-│   │   ├── tasks.md                   # Template de tasks
-│   │   ├── contracts.cs               # Template de contratos
-│   │   ├── decisions.md               # Template de ADRs
-│   │   ├── recap.md                   # Template de recap
-│   │   │
-│   │   ├── infra/                     # Templates IaC (Bicep)
-│   │   │   ├── main.bicep
-│   │   │   ├── container-app.bicep
-│   │   │   ├── container-app-env.bicep
-│   │   │   ├── sql-database.bicep
-│   │   │   ├── storage.bicep
-│   │   │   ├── key-vault.bicep
-│   │   │   ├── app-insights.bicep
-│   │   │   └── parameters.*.json
-│   │   │
-│   │   ├── integrations/              # Templates de integração
-│   │   │   ├── asaas-client.cs        # Pagamentos (PIX, Boleto)
-│   │   │   ├── asaas-webhook.cs       # Webhooks Asaas
-│   │   │   ├── clerk-config.cs        # Autenticação Clerk
-│   │   │   └── azure-identity-config.cs
-│   │   │
-│   │   └── saas/                      # Templates SaaS
-│   │       ├── subscription.cs        # Modelo de assinaturas
-│   │       └── tenant.cs              # Multi-tenancy
-│   │
-│   ├── specs/                         # Specs ativas
-│   ├── features/                      # Features em desenvolvimento
-│   └── archive/                       # Features concluídas
-│
-└── .claude/
-    ├── commands/                      # Slash commands
-    │   ├── morph-proposal.md
-    │   ├── morph-apply.md
-    │   ├── morph-status.md
-    │   ├── morph-archive.md
-    │   ├── morph-infra.md             # Gestão de infra
-    │   └── morph-costs.md             # Estimativa de custos
-    │
-    └── skills/                        # Skills dos agentes
-        ├── specialists/               # 8 agentes especialistas
-        ├── integrations/              # 3 agentes de integração
-        ├── stacks/                    # 3 stacks suportadas
-        └── infra/                     # 3 agentes de infra
-```
-
----
-
-## O Workflow das 5 Fases
-
-### Fase 1: SETUP
-```
-Gatilho: /morph-proposal <feature>
-```
-- Carrega configuração do projeto
-- Identifica agentes por keywords
-- Cria pasta de outputs
-
-### Fase 2: DESIGN
-- Gera `spec.md`, `contracts.cs`, `decisions.md`
-- Estima custos de infraestrutura
-- **⛔ PARA para aprovação**
-
-### Fase 3: CLARIFY
-- Perguntas de clarificação
-- Resolve ambiguidades
-- Valida edge cases
-
-### Fase 4: TASKS
-- Quebra em tasks (T001, T002...)
-- Define checkpoints
-- **⛔ PARA para aprovação**
-
-### Fase 5: IMPLEMENT
-```
-Gatilho: /morph-apply <feature>
-```
-- Implementa task por task
-- Testes a cada task
-- Checkpoint a cada 3 tasks
-- Gera recap final
-
----
-
-## Slash Commands
-
-| Comando | Descrição |
-|---------|-----------|
-| `/morph-proposal <feature>` | Inicia nova feature |
-| `/morph-apply <feature>` | Implementa feature aprovada |
-| `/morph-status` | Status do projeto |
-| `/morph-archive <feature>` | Arquiva feature |
-| `/morph-infra <action>` | Gestão de infraestrutura |
-| `/morph-costs` | Estimativa de custos |
-
----
-
-## Os Agentes (17 total)
-
-### Core (Sempre Ativos)
-| Agente | Responsabilidade |
-|--------|------------------|
-| 📐 Standards Architect | Padrões de código |
-| ☁️ Azure Architect | Infraestrutura cloud |
-| 💰 Cost Guardian | Controle de custos |
-
-### Stack Agents
-| Agente | Keywords |
-|--------|----------|
-| 🔥 Blazor Builder | blazor, razor, component |
-| ⚛️ NextJS Expert | nextjs, react, frontend |
-
-### Specialist Agents
-| Agente | Keywords |
-|--------|----------|
-| 🗄️ EF Modeler | entity, database, migration |
-| 🤖 MS Agent Expert | agent, ai, semantic kernel |
-| ⏰ Hangfire Orchestrator | scheduled, job, background |
-| 🎨 UI/UX Designer | wizard, dashboard, complex |
-| 📋 PO/PM Advisor | unclear, requirements, ROI |
-
-### Integration Agents
-| Agente | Keywords |
-|--------|----------|
-| 💳 Asaas Financial | asaas, payment, pix, boleto |
-| 🔐 Clerk Auth | clerk, auth, login |
-| 🆔 Azure Identity | identity, entra, microsoft |
-
-### Infra Agents
-| Agente | Keywords |
-|--------|----------|
-| 🏗️ Bicep Architect | bicep, iac, provision |
-| 🚀 DevOps Engineer | pipeline, ci/cd, deploy |
-| 📦 Container Specialist | docker, container |
-
----
-
-## Templates Disponíveis
-
-### IaC (Bicep)
-- `main.bicep` - Entry point
-- `container-app.bicep` - Azure Container Apps
-- `sql-database.bicep` - Azure SQL (Free tier)
-- `storage.bicep` - Storage Account
-- `key-vault.bicep` - Key Vault
-- `app-insights.bicep` - Monitoring
-
-### Integrações
-- `asaas-client.cs` - HTTP client Asaas completo
-- `asaas-webhook.cs` - Controller de webhooks
-- `clerk-config.cs` - Autenticação Clerk
-- `azure-identity-config.cs` - Microsoft Identity
-
-### SaaS
-- `subscription.cs` - Modelo de assinaturas
-- `tenant.cs` - Multi-tenancy completo
-
----
-
-## Exemplos Incluídos
-
-| Exemplo | Stack | Descrição |
-|---------|-------|-----------|
-| `micro-saas/` | Blazor + Asaas | SaaS com billing integrado |
-| `api-nextjs/` | .NET + Next.js | Full-stack com React |
-| `multi-agent/` | Semantic Kernel | Sistema de agentes AI |
-
-Cada exemplo contém:
-- `README.md` - Visão geral
-- `spec.md` - Especificação completa
-- `contracts.cs` - Interfaces e DTOs
-- `tasks.md` - Breakdown de implementação
-- `decisions.md` - ADRs (onde aplicável)
-
----
-
-## Limites de Custo
-
-| Nível | Limite | Requisito |
-|-------|--------|-----------|
-| Sem aprovação | Free tier | Nenhum |
-| Com aprovação | Até $10/mês | Confirmação |
-| Acima de $10 | Justificativa | ADR |
-
-### Recursos Free Tier Suportados
-- **Azure SQL** - 32GB grátis
-- **Container Apps** - Scale-to-zero
-- **Storage** - Pay-per-use mínimo
-- **App Insights** - 5GB/mês grátis
-
----
-
-## Dicas
-
-### Seja específico
-```
-❌ "Quero relatórios"
-✅ "Quero agendar relatórios de vendas por email toda segunda às 8h"
-```
-
-### Use keywords para ativar agentes
-```
-❌ "Quero processar pagamentos"
-✅ "Quero integrar Asaas para receber PIX e boleto"
-```
-
-### Aproveite os checkpoints
-- Revise specs antes de aprovar
-- Valide tasks antes de implementar
-- Use `/morph-status` para ver progresso
-
----
-
-## Próximos Passos
-
-1. Explore `.morph/examples/` para ver exemplos completos
-2. Leia `.morph/standards/` para entender os padrões
-3. Configure `.morph/config/config.json` para seu projeto
-4. Execute `/morph-proposal` para sua primeira feature!
-
----
-
-*MORPH-SPEC by Polymorphism Tech*