Skip to content

Viniciustda/OiTenta / .agents/skills/config-package-shared

config-package-shared

Verified

Reconstrói o pacote compartilhado base da aplicação, concentrando contratos reutilizáveis, classes base, erros de domínio, casos de uso e validações consumidas pelo backend, frontend e módulos de negócio.

FileKindSize
SKILL.mdskill md2.6 KB
agents/openai.yamlconfig449 B
assets/shared-template/jest.config.tsscript166 B
assets/shared-template/package.jsonmanifest594 B
assets/shared-template/src/db/create.repository.tsscript121 B
assets/shared-template/src/db/crud.repository.tsscript610 B
assets/shared-template/src/db/delete.repository.tsscript86 B
assets/shared-template/src/db/find-by-id.repository.tsscript109 B
assets/shared-template/src/db/find-page.repository.tsscript166 B
assets/shared-template/src/db/index.tsscript227 B
assets/shared-template/src/db/page-result.tsscript109 B
assets/shared-template/src/db/update.repository.tsscript121 B
assets/shared-template/src/error/domain.error.tsscript274 B
assets/shared-template/src/error/index.tsscript181 B
assets/shared-template/src/error/not-found.error.tsscript160 B
assets/shared-template/src/error/unauthorized.error.tsscript164 B
assets/shared-template/src/error/validation.error.tsscript171 B
assets/shared-template/src/error/validation.exception.tsscript283 B
assets/shared-template/src/index.tsscript129 B
assets/shared-template/src/model/entity.tsscript2.2 KB
assets/shared-template/src/model/index.tsscript26 B
assets/shared-template/src/usecase/index.tsscript28 B
assets/shared-template/src/usecase/use-case.tsscript74 B
assets/shared-template/src/validation/index.tsscript145 B
assets/shared-template/src/validation/rule.utils.tsscript2.7 KB
assets/shared-template/src/validation/rules/age.rule.tsscript996 B
assets/shared-template/src/validation/rules/alpha-numeric.rule.tsscript397 B
assets/shared-template/src/validation/rules/alpha.rule.tsscript338 B
assets/shared-template/src/validation/rules/bcrypt-hash.rule.tsscript399 B
assets/shared-template/src/validation/rules/cep.rule.tsscript332 B
assets/shared-template/src/validation/rules/cnpj.rule.tsscript1.2 KB
assets/shared-template/src/validation/rules/contains.rule.tsscript386 B
assets/shared-template/src/validation/rules/cpf.rule.tsscript987 B
assets/shared-template/src/validation/rules/date-range.rule.tsscript676 B
assets/shared-template/src/validation/rules/date-string.rule.tsscript1.6 KB
assets/shared-template/src/validation/rules/date.rule.tsscript344 B
assets/shared-template/src/validation/rules/domain.rule.tsscript529 B
assets/shared-template/src/validation/rules/email.rule.tsscript461 B
assets/shared-template/src/validation/rules/ends-with.rule.tsscript381 B
assets/shared-template/src/validation/rules/equals.rule.tsscript433 B
assets/shared-template/src/validation/rules/future-date.rule.tsscript339 B
assets/shared-template/src/validation/rules/has-lower-case.rule.tsscript314 B
assets/shared-template/src/validation/rules/has-number.rule.tsscript304 B
assets/shared-template/src/validation/rules/has-special-char.rule.tsscript350 B
assets/shared-template/src/validation/rules/has-upper-case.rule.tsscript314 B
assets/shared-template/src/validation/rules/hex-color.rule.tsscript403 B
assets/shared-template/src/validation/rules/in.rule.tsscript526 B
assets/shared-template/src/validation/rules/index.tsscript2.0 KB
assets/shared-template/src/validation/rules/integer.rule.tsscript306 B
assets/shared-template/src/validation/rules/json-string.rule.tsscript404 B
assets/shared-template/src/validation/rules/lower-case.rule.tsscript379 B
assets/shared-template/src/validation/rules/max-date.rule.tsscript498 B
assets/shared-template/src/validation/rules/max-items.rule.tsscript393 B
assets/shared-template/src/validation/rules/max-length.rule.tsscript443 B
assets/shared-template/src/validation/rules/max-value.rule.tsscript343 B
assets/shared-template/src/validation/rules/min-date.rule.tsscript498 B
assets/shared-template/src/validation/rules/min-items.rule.tsscript393 B
assets/shared-template/src/validation/rules/min-length.rule.tsscript443 B
assets/shared-template/src/validation/rules/min-value.rule.tsscript343 B
assets/shared-template/src/validation/rules/negative.rule.tsscript294 B
assets/shared-template/src/validation/rules/no-common-password.rule.tsscript725 B
assets/shared-template/src/validation/rules/no-repeat-chars.rule.tsscript492 B
assets/shared-template/src/validation/rules/no-whitespace.rule.tsscript311 B
assets/shared-template/src/validation/rules/not-equals.rule.tsscript438 B
assets/shared-template/src/validation/rules/not-in.rule.tsscript534 B
assets/shared-template/src/validation/rules/not-null.rule.tsscript214 B
assets/shared-template/src/validation/rules/not-undefined.rule.tsscript229 B
assets/shared-template/src/validation/rules/past-date.rule.tsscript335 B
assets/shared-template/src/validation/rules/person-name.rule.tsscript535 B
assets/shared-template/src/validation/rules/phone-br.rule.tsscript837 B
assets/shared-template/src/validation/rules/phone.rule.tsscript510 B
assets/shared-template/src/validation/rules/positive.rule.tsscript294 B
assets/shared-template/src/validation/rules/precision.rule.tsscript823 B
assets/shared-template/src/validation/rules/range-length.rule.tsscript516 B
assets/shared-template/src/validation/rules/range-value.rule.tsscript427 B
assets/shared-template/src/validation/rules/regex.rule.tsscript505 B
assets/shared-template/src/validation/rules/required.rule.tsscript266 B
assets/shared-template/src/validation/rules/rg.rule.tsscript348 B
assets/shared-template/src/validation/rules/slug.rule.tsscript349 B
assets/shared-template/src/validation/rules/starts-with.rule.tsscript387 B
assets/shared-template/src/validation/rules/strong-password.rule.tsscript599 B
assets/shared-template/src/validation/rules/time-string.rule.tsscript401 B
assets/shared-template/src/validation/rules/trim.rule.tsscript298 B
assets/shared-template/src/validation/rules/unique-items.rule.tsscript495 B
assets/shared-template/src/validation/rules/upper-case.rule.tsscript379 B
assets/shared-template/src/validation/rules/url.rule.tsscript482 B
assets/shared-template/src/validation/rules/uuid.rule.tsscript401 B
assets/shared-template/src/validation/validation-field.interface.tsscript161 B
assets/shared-template/src/validation/validation-rule.interface.tsscript86 B
assets/shared-template/src/validation/validator.tsscript664 B
assets/shared-template/test/index.test.tsscript1.6 KB
assets/shared-template/test/model/entity.test.tsscript5.6 KB
assets/shared-template/test/usecase/use-case.test.tsscript857 B
assets/shared-template/test/validation/rule.utils.test.tsscript2.7 KB
assets/shared-template/test/validation/rules/age.rule.test.tsscript1.3 KB
assets/shared-template/test/validation/rules/brazil-rules.test.tsscript1.6 KB
assets/shared-template/test/validation/rules/collection-rules.test.tsscript1.9 KB
assets/shared-template/test/validation/rules/contact-rules.test.tsscript1.2 KB
assets/shared-template/test/validation/rules/date-extra-rules.test.tsscript3.1 KB
assets/shared-template/test/validation/rules/date.rule.test.tsscript873 B
assets/shared-template/test/validation/rules/email.rule.test.tsscript844 B
assets/shared-template/test/validation/rules/format-rules.test.tsscript1.1 KB
assets/shared-template/test/validation/rules/logic-rules.test.tsscript1.2 KB
assets/shared-template/test/validation/rules/max-length.rule.test.tsscript771 B
assets/shared-template/test/validation/rules/min-length.rule.test.tsscript752 B
assets/shared-template/test/validation/rules/numeric-rules.test.tsscript2.1 KB
assets/shared-template/test/validation/rules/range-length.rule.test.tsscript906 B
assets/shared-template/test/validation/rules/required.rule.test.tsscript708 B
assets/shared-template/test/validation/rules/security-rules.test.tsscript2.7 KB
assets/shared-template/test/validation/rules/string-rules.test.tsscript3.2 KB
assets/shared-template/test/validation/validator.test.tsscript2.1 KB
assets/shared-template/tsconfig.jsonconfig230 B
scripts/rebuild-shared.jsexecutablescript10.2 KB

scripts/rebuild-shared.js

View on GitHub
#!/usr/bin/env node

const fs = require('node:fs');
const path = require('node:path');
const { spawnSync } = require('node:child_process');

const ROOT_DIR = process.cwd();
const SKILL_DIR = path.join(ROOT_DIR, '.agents', 'skills', 'config-package-shared');
const TEMPLATE_DIR = path.join(SKILL_DIR, 'assets', 'shared-template');
const TEMP_SCOPE = '@temp';
const TEMP_PACKAGE_NAME = `${TEMP_SCOPE}/shared`;
const DEFAULT_PACKAGE_NAME = 'shared';

function parseArgs(argv) {
  const options = {
    packageName: DEFAULT_PACKAGE_NAME,
    force: false,
  };

  for (let index = 0; index < argv.length; index += 1) {
    const arg = argv[index];

    if (arg === '--package-name') {
      const value = argv[index + 1];
      if (!value) {
        fail('Informe um valor para --package-name.');
      }

      options.packageName = value;
      index += 1;
      continue;
    }

    if (arg === '--force') {
      options.force = true;
      continue;
    }

    fail(`Argumento nao suportado: ${arg}`);
  }

  if (!/^[a-z0-9]+(?:-[a-z0-9]+)*$/.test(options.packageName)) {
    fail(
      'O nome do pacote deve usar apenas letras minusculas, numeros e hifens, por exemplo: shared ou shared-v2.',
    );
  }

  return options;
}

function fail(message) {
  throw new Error(message);
}

function exists(targetPath) {
  return fs.existsSync(targetPath);
}

function ensureDir(targetPath) {
  fs.mkdirSync(targetPath, { recursive: true });
}

function removeDir(targetPath) {
  fs.rmSync(targetPath, { recursive: true, force: true });
}

function copyDir(sourceDir, targetDir) {
  ensureDir(targetDir);

  for (const entry of fs.readdirSync(sourceDir, { withFileTypes: true })) {
    const sourcePath = path.join(sourceDir, entry.name);
    const targetPath = path.join(targetDir, entry.name);

    if (entry.isDirectory()) {
      copyDir(sourcePath, targetPath);
      continue;
    }

    fs.copyFileSync(sourcePath, targetPath);
  }
}

function readJson(filePath) {
  return JSON.parse(fs.readFileSync(filePath, 'utf8'));
}

function writeJson(filePath, value) {
  fs.writeFileSync(filePath, `${JSON.stringify(value, null, 2)}\n`);
}

function listWorkspacePackageJsonFiles() {
  const workspaceDirs = ['apps', 'modules', 'packages'];
  const files = [];

  const rootPackageJson = path.join(ROOT_DIR, 'package.json');
  if (exists(rootPackageJson)) {
    files.push(rootPackageJson);
  }

  for (const workspaceDir of workspaceDirs) {
    const absoluteWorkspaceDir = path.join(ROOT_DIR, workspaceDir);
    if (!exists(absoluteWorkspaceDir)) {
      continue;
    }

    for (const child of fs.readdirSync(absoluteWorkspaceDir, { withFileTypes: true })) {
      if (!child.isDirectory()) {
        continue;
      }

      const packageJsonPath = path.join(absoluteWorkspaceDir, child.name, 'package.json');
      if (exists(packageJsonPath)) {
        files.push(packageJsonPath);
      }
    }
  }

  return files;
}

function extractScope(packageName) {
  if (typeof packageName !== 'string') {
    return null;
  }

  const match = packageName.match(/^(@[^/]+)\/[^/]+$/);
  if (!match) {
    return null;
  }

  if (match[1] === TEMP_SCOPE) {
    return null;
  }

  return match[1];
}

function scorePackageJson(packageJsonPath) {
  const normalizedPath = packageJsonPath.replace(`${ROOT_DIR}${path.sep}`, '');

  if (normalizedPath === 'package.json') {
    return 1000;
  }

  if (normalizedPath.startsWith(`apps${path.sep}`)) {
    return 100;
  }

  if (normalizedPath.startsWith(`modules${path.sep}`)) {
    return 50;
  }

  if (normalizedPath.startsWith(`packages${path.sep}`)) {
    return 10;
  }

  return 1;
}

function detectWorkspaceScope() {
  const scores = new Map();

  for (const packageJsonPath of listWorkspacePackageJsonFiles()) {
    const packageJson = readJson(packageJsonPath);
    const scope = extractScope(packageJson.name);
    if (!scope) {
      continue;
    }

    const current = scores.get(scope) ?? { score: 0, occurrences: 0 };
    current.score += scorePackageJson(packageJsonPath);
    current.occurrences += 1;
    scores.set(scope, current);
  }

  const sortedScopes = [...scores.entries()].sort((left, right) => {
    if (right[1].score !== left[1].score) {
      return right[1].score - left[1].score;
    }

    if (right[1].occurrences !== left[1].occurrences) {
      return right[1].occurrences - left[1].occurrences;
    }

    return left[0].localeCompare(right[0]);
  });

  if (sortedScopes.length === 0) {
    fail(
      'Nao foi possivel detectar o scope do workspace a partir dos package.json da raiz, apps, modules e packages.',
    );
  }

  return sortedScopes[0][0];
}

function listFilesRecursively(dirPath) {
  const files = [];

  if (!exists(dirPath)) {
    return files;
  }

  for (const entry of fs.readdirSync(dirPath, { withFileTypes: true })) {
    const absolutePath = path.join(dirPath, entry.name);

    if (entry.isDirectory()) {
      if (['node_modules', 'dist', 'coverage', '.turbo', '.next'].includes(entry.name)) {
        continue;
      }

      files.push(...listFilesRecursively(absolutePath));
      continue;
    }

    files.push(absolutePath);
  }

  return files;
}

function packageJsonHasSharedDependency(packageJson) {
  const sections = ['dependencies', 'devDependencies', 'peerDependencies', 'optionalDependencies'];

  return sections.some((section) => {
    const deps = packageJson[section];
    if (!deps || typeof deps !== 'object') {
      return false;
    }

    return Object.keys(deps).some((dependencyName) => /^@[^/]+\/shared$/.test(dependencyName));
  });
}

function workspaceImportsShared(workspaceDir) {
  const files = listFilesRecursively(workspaceDir);
  const sharedImportPattern =
    /(?:from\s+['"](@[^/'"]+\/shared)['"])|(?:require\(\s*['"](@[^/'"]+\/shared)['"]\s*\))/;

  for (const filePath of files) {
    if (!/\.(cjs|cts|js|jsx|mjs|mts|ts|tsx)$/.test(filePath)) {
      continue;
    }

    const content = fs.readFileSync(filePath, 'utf8');
    if (sharedImportPattern.test(content)) {
      return true;
    }
  }

  return false;
}

function normalizeSharedDependency(packageJsonPath, sharedPackageName) {
  const packageJson = readJson(packageJsonPath);
  const workspaceDir = path.dirname(packageJsonPath);
  const usesShared =
    packageJsonHasSharedDependency(packageJson) || workspaceImportsShared(workspaceDir);

  if (!usesShared) {
    return false;
  }

  for (const section of ['dependencies', 'devDependencies', 'peerDependencies', 'optionalDependencies']) {
    const deps = packageJson[section];
    if (!deps || typeof deps !== 'object') {
      continue;
    }

    for (const dependencyName of Object.keys(deps)) {
      if (/^@[^/]+\/shared$/.test(dependencyName)) {
        delete deps[dependencyName];
      }
    }

    if (Object.keys(deps).length === 0) {
      delete packageJson[section];
    }
  }

  packageJson.dependencies = packageJson.dependencies ?? {};
  packageJson.dependencies[sharedPackageName] = '*';
  packageJson.dependencies = Object.fromEntries(
    Object.entries(packageJson.dependencies).sort(([left], [right]) => left.localeCompare(right)),
  );

  writeJson(packageJsonPath, packageJson);
  return true;
}

function sortDependencies(packageJson) {
  for (const section of ['dependencies', 'devDependencies', 'peerDependencies', 'optionalDependencies']) {
    if (!packageJson[section] || typeof packageJson[section] !== 'object') {
      continue;
    }

    packageJson[section] = Object.fromEntries(
      Object.entries(packageJson[section]).sort(([left], [right]) => left.localeCompare(right)),
    );
  }
}

function runCommand(command, args) {
  const result = spawnSync(command, args, {
    cwd: ROOT_DIR,
    stdio: 'inherit',
    env: process.env,
  });

  if (result.status !== 0) {
    fail(`Falha ao executar: ${command} ${args.join(' ')}`);
  }
}

function main() {
  const options = parseArgs(process.argv.slice(2));
  const targetDir = path.join(ROOT_DIR, 'packages', options.packageName);

  if (!exists(TEMPLATE_DIR)) {
    fail(`Template nao encontrado em ${TEMPLATE_DIR}`);
  }

  ensureDir(path.join(ROOT_DIR, 'packages'));
  if (options.packageName === DEFAULT_PACKAGE_NAME) {
    removeDir(targetDir);
  } else if (exists(targetDir) && !options.force) {
    fail(
      `O diretorio ${path.relative(ROOT_DIR, targetDir)} ja existe. Use outro nome ou rode novamente com --force se quiser recria-lo.`,
    );
  } else if (exists(targetDir) && options.force) {
    removeDir(targetDir);
  }

  copyDir(TEMPLATE_DIR, targetDir);

  const scope = detectWorkspaceScope();
  const sharedPackageName = `${scope}/${options.packageName}`;
  const targetPackageJsonPath = path.join(targetDir, 'package.json');
  const targetPackageJson = readJson(targetPackageJsonPath);

  if (targetPackageJson.name !== TEMP_PACKAGE_NAME) {
    fail(
      `O template esperado deve usar ${TEMP_PACKAGE_NAME}, mas encontrou ${targetPackageJson.name ?? '<sem nome>'}.`,
    );
  }

  targetPackageJson.name = sharedPackageName;
  sortDependencies(targetPackageJson);
  writeJson(targetPackageJsonPath, targetPackageJson);

  const updatedWorkspaces = [];
  if (options.packageName === DEFAULT_PACKAGE_NAME) {
    for (const workspaceRoot of ['apps', 'modules']) {
      const absoluteWorkspaceRoot = path.join(ROOT_DIR, workspaceRoot);
      if (!exists(absoluteWorkspaceRoot)) {
        continue;
      }

      for (const child of fs.readdirSync(absoluteWorkspaceRoot, { withFileTypes: true })) {
        if (!child.isDirectory()) {
          continue;
        }

        const packageJsonPath = path.join(absoluteWorkspaceRoot, child.name, 'package.json');
        if (!exists(packageJsonPath)) {
          continue;
        }

        if (normalizeSharedDependency(packageJsonPath, sharedPackageName)) {
          updatedWorkspaces.push(path.relative(ROOT_DIR, packageJsonPath));
        }
      }
    }
  }

  runCommand('npm', ['i']);
  runCommand('npx', ['turbo', 'run', 'build', '--filter', sharedPackageName]);

  console.log('');
  console.log(`Scope detectado: ${scope}`);
  console.log(`Pacote recriado: ${path.relative(ROOT_DIR, targetDir)}`);
  console.log(`Nome final do pacote: ${sharedPackageName}`);
  console.log('Workspaces com dependencia normalizada:');

  if (updatedWorkspaces.length === 0) {
    console.log('- nenhum workspace precisou de atualizacao');
  } else {
    for (const workspace of updatedWorkspaces) {
      console.log(`- ${workspace}`);
    }
  }
}

main();
brainstormingobra/superpowersYou MUST use this before any creative work - creating features, building components, adding functionality, modifying behavior, or planning anything new, in software or out of it (a talk, a business, a renovation).Stars: 322kUpdated Claude CodeCodexVerifiedInstall
brand-guidelinesanthropics/skillsApplies Anthropic's official brand colors and typography to any sort of artifact that may benefit from having Anthropic's look-and-feel. Use it when brand colors or style guidelines, visual formatting, or company design standards apply.Stars: 197kUpdated Claude CodeCodexVerifiedInstall
frontend-designanthropics/skillsGuidance for distinctive, intentional visual design when building new UI or reshaping an existing one. Helps with aesthetic direction, typography, and making choices that don't read as templated defaults.Stars: 197kUpdated Claude CodeCodexVerifiedInstall
mcp-builderanthropics/skillsGuide for creating high-quality MCP (Model Context Protocol) servers that enable LLMs to interact with external services through well-designed tools. Use when building MCP servers to integrate external APIs or services, whether in Python (FastMCP) or Node/TypeScript (MCP SDK).Stars: 197kUpdated Claude CodeCodexVerifiedInstall