DeepSeek Harness: Publicação de Plugins

# Compilar TypeScript
pnpm build

# Confirmar saída
ls dist/
# index.js  index.d.ts  ...

# Primeira publicação
npm publish --access public

# Publicar após atualização de versão
npm version patch  # 1.0.0 → 1.0.1
npm publish

# .npmignore
src/
tests/
tsconfig.json
*.tsbuildinfo
.git/
.vscode/

# Instalar em outro projeto
pnpm add @dsh-plugin/my-tool

# Verificar importação
node -e "console.log(require('@dsh-plugin/my-tool'))"

{
  "name": "@dsh-plugin/my-tool",
  "version": "1.0.0",
  "main": "dist/index.js",
  "types": "dist/index.d.ts",
  "dsh": {
    "name": "my-tool",
    "description": "A custom tool for DSH",
    "services": ["tools"],
    "inject": ["tools"],
    "capabilities": [],
    "compatibility": {
      "dsh": ">=0.5.0",
      "cordis": ">=1.0.0"
    },
    "permissions": [
      "fs.read",
      "network.outbound"
    ],
    "config": {
      "apiKey": {
        "type": "string",
        "required": true,
        "description": "API key for the service"
      }
    }
  }
}

Repository Settings → Topics → Add topic: dsh-plugin

# Busca via GitHub CLI
gh search repos --topic dsh-plugin --sort stars

# Busca web no GitHub
https://github.com/topics/dsh-plugin

dsh-plugin        ← Obrigatório
deepseek-harness  ← Opcional, aumenta descobribilidade
Tipo de Tool      ← ex.: database, search, devops

Quando incrementar PATCH:
  - Corrigir um bug de tool
  - Corrigir um problema de validação de config
  - Atualização de documentação

Quando incrementar MINOR:
  - Adicionar uma nova tool
  - Adicionar uma opção de config (com valor padrão)
  - Adicionar uma implementação de capability
  - Adicionar dependências opcionais

Quando incrementar MAJOR:
  - Remover uma tool
  - Alterar formato de parâmetro de tool
  - Remover uma opção de config
  - Alterar lista de inject
  - Alterar interface de Capability

# Incrementar PATCH
npm version patch -m "fix: resolve timeout issue"

# Incrementar MINOR
npm version minor -m "feat: add batch query tool"

# Incrementar MAJOR
npm version major -m "breaking: change tool parameter format"

# Versão Alpha
npm version prealpha --preid alpha
# 1.0.0 → 1.1.0-alpha.0

# Versão Beta
npm version prebeta --preid beta
# 1.0.0 → 1.1.0-beta.0

# Versão RC
npm version prerelease --preid rc
# 1.1.0-beta.0 → 1.1.0-rc.0

{
  "dsh": {
    "compatibility": {
      "dsh": ">=0.5.0",
      "cordis": ">=1.0.0",
      "node": ">=18.0.0"
    }
  },
  "peerDependencies": {
    "@deepseek-ai/dsh": ">=0.5.0",
    "@deepseek-ai/cordis": ">=1.0.0"
  }
}

# Verificação integrada do DSH
dsh plugin check @dsh-plugin/my-tool

# Saída
✅ Compatible with dsh@0.5.0
✅ Compatible with cordis@1.0.0
⚠️ Requires Node.js >= 18.0.0 (current: 16.20.0)

# @dsh-plugin/my-tool

> DSH plugin for [descrição da funcionalidade]

## Instalação

\```bash
dsh plugin add @dsh-plugin/my-tool
\```

## Configuração

\```yaml
plugins:
  '@dsh-plugin/my-tool':
    config:
      apiKey: sk-xxx
      maxRetries: 3
\```

## Tools Fornecidas

| Tool | Descrição |
|:-----|:----------|
| `my_tool` | Faz algo útil |

## Dependências

- DSH >= 0.5.0
- Cordis >= 1.0.0

## Permissões

- fs.read
- network.outbound

### ▶ Exemplo：
\```text
👤 Alice: Analyze project with my_tool

🤖 Agent:
🔧 Using tool: my_tool
  → Result: ...
\```

## Licença

MIT

# Changelog

## 1.1.0 (2026-08-20)

### Added
- batch_query tool para consultar múltiplos caminhos
- Opção de config `maxDepth` para análise recursiva

### Fixed
- Tratamento de timeout para diretórios grandes

## 1.0.0 (2026-08-01)

### Breaking
- Alterado formato de parâmetro de `dir_path` para `path`

### Added
- Lançamento inicial com ferramenta file_info