@polymorphism-tech/morph-spec 1.0.4 → 2.0.0

package/LICENSE

@@ -0,0 +1,72 @@
+Proprietary License
+
+Copyright (c) 2024-2025 Polymorphism Tech
+All rights reserved.
+
+MORPH-SPEC Framework - Proprietary Software License
+
+1. GRANT OF LICENSE
+
+Subject to the terms and conditions of this License, Polymorphism Tech ("Licensor")
+grants you a limited, non-exclusive, non-transferable license to:
+
+a) Install and use the MORPH-SPEC CLI tool for personal or commercial projects
+b) Use the generated templates and code in your own projects
+c) Modify generated code for your specific use cases
+
+2. RESTRICTIONS
+
+You may NOT:
+
+a) Redistribute, sell, lease, or sublicense the MORPH-SPEC framework itself
+b) Modify, decompile, reverse engineer, or create derivative works of the framework
+c) Remove or modify any copyright notices or proprietary markings
+d) Use the framework to create competing products or services
+e) Publicly fork or redistribute the source code
+f) Share access credentials to private repositories
+
+3. OWNERSHIP
+
+The MORPH-SPEC framework, including all code, documentation, templates, and
+associated materials, remains the exclusive property of Polymorphism Tech.
+
+4. GENERATED CODE
+
+Code and projects generated using MORPH-SPEC are yours to use, modify, and
+distribute as you see fit, including commercial use.
+
+5. SUPPORT AND UPDATES
+
+- CLI tool updates are provided via npm registry
+- Support is available at: support@polymorphism.tech
+- Documentation updates are included with each release
+
+6. WARRANTY DISCLAIMER
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT.
+
+7. LIMITATION OF LIABILITY
+
+IN NO EVENT SHALL POLYMORPHISM TECH BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.
+
+8. TERMINATION
+
+This license is effective until terminated. Your rights under this license will
+terminate automatically without notice if you fail to comply with any term of
+this license.
+
+9. CONTACT
+
+For licensing inquiries, custom licenses, or commercial support:
+Email: contact@polymorphism.com.br
+Website: https://polymorphism.com.br
+
+---
+
+MORPH-SPEC v2.0.0
+by Polymorphism Tech

package/README.md

@@ -19,6 +19,13 @@
   <a href="docs/">Documentação</a>
 </p>
 
+<p align="center">
+  <strong>📚 Guias de Uso:</strong>
+  <a href="QUICKSTART.md">Quick Start</a> •
+  <a href="CHEATSHEET.md">Cheat Sheet</a> •
+  <a href="docs/README.md">API Docs</a>
+</p>
+
 ---
 
 ## O que é MORPH-SPEC?
@@ -86,8 +93,10 @@ npx @polymorphism-tech/morph-spec init
 |---------|-----------|
 | `morph-spec init` | Inicializa MORPH no diretório atual |
 | `morph-spec init --force` | Sobrescreve instalação existente |
-| `morph-spec update` | Atualiza templates e standards |
-| `morph-spec doctor` | Verifica saúde da instalação |
+| `morph-spec update` | Atualiza projeto para versão mais recente |
+| `morph-spec update --templates` | Atualiza apenas templates |
+| `morph-spec update --standards` | Atualiza apenas standards |
+| `morph-spec doctor` | Verifica saúde e versões da instalação |
 
 ### Verificar Instalação
 
@@ -95,6 +104,11 @@ npx @polymorphism-tech/morph-spec init
 morph-spec doctor
 ```
 
+O comando `doctor` verifica:
+- ✓ Versão do CLI (se está atualizada)
+- ✓ Versão do MORPH no projeto
+- ✓ Estrutura de arquivos e configurações
+
 Ou abra seu projeto no Claude Code e execute:
 ```
 /morph-status
@@ -102,6 +116,48 @@ Ou abra seu projeto no Claude Code e execute:
 
 ---
 
+## Mantendo Atualizado
+
+### 1. Verificar se há atualizações
+
+```bash
+morph-spec doctor
+```
+
+Isso mostrará se há versões mais recentes disponíveis.
+
+### 2. Atualizar para a versão mais recente
+
+**Instalação Global:**
+```bash
+# Primeiro, atualize o CLI
+npm install -g @polymorphism-tech/morph-spec@latest
+
+# Depois, atualize seu projeto
+cd /caminho/do/seu/projeto
+morph-spec update
+```
+
+**Usando npx (Recomendado - sempre pega a versão mais recente):**
+```bash
+cd /caminho/do/seu/projeto
+npx @polymorphism-tech/morph-spec@latest update
+```
+
+### 3. O que é atualizado?
+
+O comando `update` sincroniza:
+- ✅ Templates (`.morph/templates/`)
+- ✅ Standards (`.morph/standards/`)
+- ✅ Agentes (`.morph/config/agents.json`)
+- ✅ Comandos Claude (`.claude/commands/`)
+- ✅ Skills (`.claude/skills/`)
+- ✅ Instruções (CLAUDE.md)
+
+**Importante:** Seu `config.json` é preservado!
+
+---
+
 ## Começando
 
 ### 1. Criar uma Proposta
@@ -286,18 +342,45 @@ O MORPH segue a filosofia **"Free tier first"**:
 
 ---
 
-## Licença
+## 📄 Licença e Distribuição
+
+**Repositório:** Privado (código fonte protegido)
+**Package npm:** Público e gratuito via `@polymorphism-tech/morph-spec`
+
+### Licença Proprietária
+
+O MORPH-SPEC framework é software proprietário da Polymorphism Tech. Veja [LICENSE](LICENSE) para detalhes.
+
+**Você PODE:**
+- ✅ Usar o CLI tool gratuitamente
+- ✅ Gerar projetos para uso pessoal ou comercial
+- ✅ Modificar código gerado pelos templates
+- ✅ Distribuir seus projetos criados com MORPH-SPEC
+
+**Você NÃO PODE:**
+- ❌ Redistribuir ou vender o framework
+- ❌ Criar produtos derivados competidores
+- ❌ Modificar ou fazer engenharia reversa do framework
+- ❌ Remover avisos de copyright
+
+### Código Gerado
+
+Todo código gerado usando MORPH-SPEC é **100% seu** para usar como quiser, incluindo uso comercial.
+
+### Suporte
 
-MIT © [Polymorphism Tech](https://polymorphism.tech)
+- 📧 Email: support@polymorphism.com.br
+- 🌐 Website: https://polymorphism.com.br
+- 📦 npm: [@polymorphism-tech/morph-spec](https://www.npmjs.com/package/@polymorphism-tech/morph-spec)
 
 ---
 
 ## Links
 
-- 📦 [npm](https://www.npmjs.com/package/@polymorphism-tech/morph-spec)
+- 📦 [npm Package](https://www.npmjs.com/package/@polymorphism-tech/morph-spec)
 - 📚 [Documentação](docs/)
 - 💡 [Exemplos](content/.morph/examples/)
-- 🐛 [Issues](https://github.com/polymorphism-tech/morph-spec-framework/issues)
+- 🌐 [Polymorphism Tech](https://polymorphism.com.br)
 
 ---
 

package/bin/detect-agents.js

@@ -0,0 +1,225 @@
+#!/usr/bin/env node
+
+/**
+ * MORPH-SPEC Agent Detection CLI
+ *
+ * Detecta automaticamente quais agentes devem ser ativados baseado
+ * em keywords no input do usuário.
+ *
+ * Uso:
+ *   node bin/detect-agents.js "implementar jobs agendados"
+ *   node bin/detect-agents.js --verbose "criar dashboard com charts"
+ *   node bin/detect-agents.js --json "adicionar background tasks"
+ */
+
+import { readFileSync } from 'fs';
+import { join, dirname } from 'path';
+import { fileURLToPath } from 'url';
+
+const __dirname = dirname(fileURLToPath(import.meta.url));
+const AGENTS_CONFIG_PATH = join(__dirname, '../content/.morph/config/agents.json');
+
+// Cores para output no terminal
+const colors = {
+  reset: '\x1b[0m',
+  bright: '\x1b[1m',
+  green: '\x1b[32m',
+  yellow: '\x1b[33m',
+  blue: '\x1b[34m',
+  cyan: '\x1b[36m',
+  gray: '\x1b[90m'
+};
+
+function log(message, color = 'reset') {
+  console.log(`${colors[color]}${message}${colors.reset}`);
+}
+
+/**
+ * Carrega configuração de agentes
+ * @returns {Object} Configuração de agentes
+ */
+function loadAgentsConfig() {
+  try {
+    const content = readFileSync(AGENTS_CONFIG_PATH, 'utf8');
+    return JSON.parse(content);
+  } catch (err) {
+    console.error(`ERROR: Failed to load agents config: ${err.message}`);
+    process.exit(1);
+  }
+}
+
+/**
+ * Detecta agentes baseado em user input
+ * @param {string} userInput - Input do usuário
+ * @param {Object} config - Configuração de agentes
+ * @returns {Object} Resultado da detecção { core, specialists, all, matches }
+ */
+function detectAgents(userInput, config) {
+  const input = userInput.toLowerCase();
+  const coreAgents = config.agents.core || [];
+  const specialists = config.agents.specialists || [];
+
+  // Core agents sempre ativos
+  const coreIds = coreAgents.map(a => a.id);
+
+  // Detectar specialists por keyword matching
+  const specialistMatches = [];
+
+  for (const agent of specialists) {
+    const keywords = agent.autoActivation?.keywords || [];
+    const matchedKeywords = [];
+
+    for (const keyword of keywords) {
+      if (input.includes(keyword.toLowerCase())) {
+        matchedKeywords.push(keyword);
+      }
+    }
+
+    if (matchedKeywords.length > 0) {
+      specialistMatches.push({
+        id: agent.id,
+        name: agent.name,
+        emoji: agent.emoji,
+        matchedKeywords: matchedKeywords,
+        matchCount: matchedKeywords.length
+      });
+    }
+  }
+
+  // Ordenar por número de matches (mais relevante primeiro)
+  specialistMatches.sort((a, b) => b.matchCount - a.matchCount);
+
+  const specialistIds = specialistMatches.map(m => m.id);
+  const allIds = [...new Set([...coreIds, ...specialistIds])];
+
+  return {
+    core: coreIds,
+    specialists: specialistIds,
+    all: allIds,
+    matches: specialistMatches,
+    input: userInput
+  };
+}
+
+/**
+ * Formata output em modo verbose
+ * @param {Object} result - Resultado da detecção
+ */
+function formatVerbose(result) {
+  log('\n╔════════════════════════════════════════════════════════════════╗', 'cyan');
+  log('║                    AGENT DETECTION RESULT                      ║', 'cyan');
+  log('╠════════════════════════════════════════════════════════════════╣', 'cyan');
+  log(`║ Input: ${result.input.substring(0, 54).padEnd(54)} ║`, 'bright');
+  log('╠════════════════════════════════════════════════════════════════╣', 'cyan');
+  log('║ CORE AGENTS (always active)                                    ║', 'cyan');
+  log('╠════════════════════════════════════════════════════════════════╣', 'cyan');
+
+  result.core.forEach(id => {
+    log(`║   ✓ ${id.padEnd(58)}║`, 'green');
+  });
+
+  if (result.specialists.length > 0) {
+    log('╠════════════════════════════════════════════════════════════════╣', 'cyan');
+    log('║ SPECIALIST AGENTS (keyword matched)                            ║', 'cyan');
+    log('╠════════════════════════════════════════════════════════════════╣', 'cyan');
+
+    result.matches.forEach(match => {
+      const line = `${match.emoji} ${match.name} (${match.matchCount} matches)`;
+      log(`║   ${line.padEnd(61)}║`, 'yellow');
+      const keywords = match.matchedKeywords.join(', ');
+      const keywordLine = `Keywords: ${keywords}`;
+      // Quebrar em múltiplas linhas se necessário
+      if (keywordLine.length > 58) {
+        const chunks = keywordLine.match(/.{1,58}/g) || [];
+        chunks.forEach((chunk, i) => {
+          log(`║     ${chunk.padEnd(59)}║`, 'gray');
+        });
+      } else {
+        log(`║     ${keywordLine.padEnd(59)}║`, 'gray');
+      }
+    });
+  } else {
+    log('╠════════════════════════════════════════════════════════════════╣', 'cyan');
+    log('║ No specialist agents matched                                   ║', 'gray');
+  }
+
+  log('╠════════════════════════════════════════════════════════════════╣', 'cyan');
+  log(`║ TOTAL: ${result.all.length} agents activated                                      ║`, 'bright');
+  log('╚════════════════════════════════════════════════════════════════╝\n', 'cyan');
+}
+
+/**
+ * Formata output em modo simples (apenas IDs)
+ * @param {Object} result - Resultado da detecção
+ */
+function formatSimple(result) {
+  result.all.forEach(id => console.log(id));
+}
+
+/**
+ * Formata output em modo JSON
+ * @param {Object} result - Resultado da detecção
+ */
+function formatJSON(result) {
+  console.log(JSON.stringify(result, null, 2));
+}
+
+// ============================================================================
+// MAIN
+// ============================================================================
+
+function main() {
+  const args = process.argv.slice(2);
+
+  // Parse flags
+  const hasVerbose = args.includes('--verbose') || args.includes('-v');
+  const hasJSON = args.includes('--json') || args.includes('-j');
+  const hasHelp = args.includes('--help') || args.includes('-h');
+  const hasIdsOnly = args.includes('--ids-only') || args.includes('-i');
+
+  // Remove flags para pegar user input
+  const userInput = args
+    .filter(arg => !arg.startsWith('--') && !arg.startsWith('-'))
+    .join(' ');
+
+  if (hasHelp || args.length === 0) {
+    log('\nMORPH-SPEC Agent Detection CLI', 'bright');
+    log('\nUsage:', 'cyan');
+    log('  node bin/detect-agents.js [options] "<user input>"', 'gray');
+    log('\nOptions:', 'cyan');
+    log('  -v, --verbose     Show detailed detection results', 'gray');
+    log('  -j, --json        Output full result as JSON', 'gray');
+    log('  -i, --ids-only    Output only agent IDs (one per line)', 'gray');
+    log('  -h, --help        Show this help', 'gray');
+    log('\nExamples:', 'cyan');
+    log('  node bin/detect-agents.js "criar dashboard com charts"', 'gray');
+    log('  node bin/detect-agents.js --verbose "implementar jobs agendados"', 'gray');
+    log('  node bin/detect-agents.js --json "adicionar RAG pipeline"', 'gray');
+    log('  node bin/detect-agents.js --ids-only "background tasks"\n', 'gray');
+    process.exit(0);
+  }
+
+  if (!userInput) {
+    console.error('ERROR: User input is required');
+    console.error('Run with --help for usage information');
+    process.exit(1);
+  }
+
+  // Carregar config e detectar agentes
+  const config = loadAgentsConfig();
+  const result = detectAgents(userInput, config);
+
+  // Formatar output
+  if (hasJSON) {
+    formatJSON(result);
+  } else if (hasVerbose) {
+    formatVerbose(result);
+  } else if (hasIdsOnly) {
+    formatSimple(result);
+  } else {
+    // Default: JSON compact (só all array)
+    console.log(JSON.stringify(result.all));
+  }
+}
+
+main();

package/bin/morph-spec.js

@@ -9,6 +9,15 @@ import { readFileSync } from 'fs';
 import { initCommand } from '../src/commands/init.js';
 import { updateCommand } from '../src/commands/update.js';
 import { doctorCommand } from '../src/commands/doctor.js';
+import { detectCommand } from '../src/commands/detect.js';
+import { syncCommand } from '../src/commands/sync.js';
+import { createStoryCommand } from '../src/commands/create-story.js';
+import { shardSpecCommand } from '../src/commands/shard-spec.js';
+import { sprintStatusCommand } from '../src/commands/sprint-status.js';
+import { stateCommand } from '../src/commands/state.js';
+import { costCommand } from '../src/commands/cost.js';
+import { generateDesignSystemCommand } from '../src/commands/generate.js';
+import { updateResourcePricing, showPricing, validatePricing } from '../src/commands/update-pricing.js';
 
 const __dirname = dirname(fileURLToPath(import.meta.url));
 const pkg = JSON.parse(readFileSync(join(__dirname, '..', 'package.json'), 'utf8'));
@@ -50,4 +59,115 @@ program
   .description('Check MORPH installation health')
   .action(doctorCommand);
 
+program
+  .command('detect')
+  .description('Detect project stack, architecture, and patterns')
+  .option('-p, --path <path>', 'Project path (default: current directory)')
+  .option('-v, --verbose', 'Show detailed detection results')
+  .option('--no-save', 'Do not save results to .morph/project/')
+  .action(detectCommand);
+
+program
+  .command('sync')
+  .description('Sync standards from feature decisions')
+  .option('-p, --path <path>', 'Project path (default: current directory)')
+  .option('--dry-run', 'Show what would be synced without updating files')
+  .action(syncCommand);
+
+// Story-driven development commands
+const storyCommand = program
+  .command('story')
+  .description('Story-driven development commands');
+
+storyCommand
+  .command('create <feature> <story-id>')
+  .description('Create a new story with auto-injected Dev Notes')
+  .option('--title <title>', 'Story title')
+  .option('--epic <epic>', 'Epic name')
+  .option('--context <context>', 'Story context')
+  .option('--tasks <tasks>', 'Comma-separated tasks')
+  .option('--dry-run', 'Preview without writing file')
+  .action(createStoryCommand);
+
+storyCommand
+  .command('shard <feature>')
+  .description('Shard spec.md into manageable chunks (90% token savings)')
+  .option('--dry-run', 'Preview shards without writing files')
+  .option('--verbose', 'Show detailed shard info')
+  .action(shardSpecCommand);
+
+storyCommand
+  .command('status <feature> [action] [story-id]')
+  .description('Manage sprint status (show | start | qa | done | next)')
+  .action(sprintStatusCommand);
+
+// State management commands
+program
+  .command('state <action> [args...]')
+  .description('Manage state.json (init | get | set | checkpoint | list | add-agent | remove-agent | mark-output)')
+  .option('--force', 'Force overwrite (init command)')
+  .option('--project <name>', 'Project name (init command)')
+  .option('--type <type>', 'Project type (init command)')
+  .option('--json', 'Output as JSON (get command)')
+  .action((action, args, options) => stateCommand(action, args, options));
+
+// Cost calculation command
+program
+  .command('cost <bicep-files>')
+  .description('Calculate Azure infrastructure costs from Bicep files')
+  .option('--config <path>', 'Custom config path')
+  .option('--verbose', 'Show detailed breakdown')
+  .option('--json', 'Output as JSON')
+  .option('--strict', 'Exit with error if cost exceeds ADR threshold')
+  .action(costCommand);
+
+// Pricing management commands
+const pricingCommand = program
+  .command('pricing')
+  .description('Manage Azure pricing table');
+
+pricingCommand
+  .command('show [resource-type]')
+  .description('Show current pricing (all or specific resource type)')
+  .option('--json', 'Output as JSON')
+  .action((resourceType, options) => showPricing({ resourceType, format: options.json ? 'json' : 'table' }));
+
+pricingCommand
+  .command('update <resource-type> <sku> <price>')
+  .description('Update pricing for a specific SKU')
+  .option('--dry-run', 'Preview without saving')
+  .option('--no-validate', 'Skip validation')
+  .action((resourceType, sku, price, options) =>
+    updateResourcePricing({
+      resourceType,
+      sku,
+      price: parseFloat(price),
+      dryRun: options.dryRun,
+      validate: options.validate !== false
+    })
+  );
+
+pricingCommand
+  .command('validate')
+  .description('Validate pricing file against JSON schema')
+  .action(validatePricing);
+
+// Generation commands
+const generateCommand = program
+  .command('generate')
+  .description('Generate code from templates');
+
+generateCommand
+  .command('design-system <ui-design-system-md>')
+  .description('Generate CSS + theme files from ui-design-system.md')
+  .option('--fluent', 'Generate only Fluent UI theme')
+  .option('--mud', 'Generate only MudBlazor theme')
+  .option('--both', 'Generate both themes (default)')
+  .option('--namespace <ns>', 'C# namespace (default: YourProject.Themes)')
+  .option('--css-output <path>', 'CSS output path (default: wwwroot/css/design-system.css)')
+  .option('--fluent-output <path>', 'Fluent theme output path (default: Themes/FluentDesignTheme.cs)')
+  .option('--mud-output <path>', 'MudBlazor theme output path (default: Themes/MudDesignTheme.cs)')
+  .option('--dry-run', 'Preview without writing files')
+  .action(generateDesignSystemCommand);
+
 program.parse();