open-index/open-npm huggingface dataset:
npm package: @mainahq/cli
Description: Maina CLI — verification-first developer OS command-line interface
Latest version: 1.1.5

# @maina/cli

Command-line interface for Maina — the verification-first developer OS.

## Install

```bash
bunx maina          # Run without installing
bun add -g @maina/cli  # Install globally
```

## Commands

### Define
- `maina ticket` — Create GitHub Issue with module tagging
- `maina context` — Generate focused codebase context
- `maina explain` — Mermaid dependency diagrams + module summaries
- `maina design` — Scaffold Architecture Decision Records with HLD/LLD
- `maina review-design` — Review ADR against constitution

### Build
- `maina plan` — Create feature branch with structured spec/plan
- `maina spec` — Generate TDD test stubs from plan
- `maina commit` — Syntax guard + parallel verification + git commit

### Verify
- `maina verify` — Full verification pipeline (12 tools)
- `maina verify --deep` — Add AI semantic review
- `maina verify --visual` — Add Playwright visual regression
- `maina slop` — Standalone AI slop pattern detection
- `maina analyze` — Cross-artifact consistency check
- `maina pr` — Create PR with two-stage review + verification proof

### Meta
- `maina learn` — Analyse feedback, evolve prompts via A/B testing
- `maina visual update` — Capture visual baselines
- `maina stats` — Verification metrics and trends
- `maina doctor` — Tool health check
- `maina init` — Bootstrap Maina in any repo
- `maina init --install` — Auto-install missing verification tools

## License

Apache-2.0
npm package: @mainahq/core
Description: Maina core engines — Context, Prompt, and Verify for verification-first development
Latest version: 1.1.3

# @maina/core

Core engines for the Maina verification-first developer OS.

Three engines: **Context** (observes), **Prompt** (learns), **Verify** (verifies).

## Features

- **Context Engine** — 4-layer retrieval (Working, Episodic, Semantic, Retrieval) with PageRank relevance and dynamic token budget
- **Prompt Engine** — Constitution + custom prompts + A/B testing + feedback-driven evolution
- **Verify Engine** — 12-tool pipeline (Biome, Semgrep, Trivy, Secretlint, SonarQube, Stryker, diff-cover, AI review, slop detection, visual regression) with diff-only filtering
- **Multi-language** — TypeScript, Python, Go, Rust with language-specific profiles
- **Workflow context** — rolling summary forwarded between lifecycle steps
- **Background RL** — async feedback recording at each workflow step

## Requirements

**Runtime: Bun** (not Node.js). This package ships TypeScript source directly and requires a TypeScript-aware runtime.

## Usage

```typescript
import { runPipeline, detectLanguages, tryAIGenerate } from "@maina/core";

const result = await runPipeline({ cwd: ".", diffOnly: true });
console.log(result.passed ? "Clean" : `${result.findings.length} findings`);
```

## License

Apache-2.0
npm package: @mainahq/mcp
Description: Maina MCP server — Model Context Protocol bridge for AI host agents
Latest version: 1.1.3

# @maina/mcp

MCP (Model Context Protocol) server for Maina. Works with Claude Code, Cursor, Codex, and any MCP-compatible host.

## Setup

```json
{
  "mcpServers": {
    "maina": {
      "command": "maina",
      "args": ["--mcp"]
    }
  }
}
```

## Tools

| Tool | Description |
|------|-------------|
| `getContext` | Get focused codebase context for a command |
| `getConventions` | Get project constitution and conventions |
| `suggestTests` | Generate TDD test stubs |
| `checkSlop` | Check code for AI-generated slop patterns |
| `reviewCode` | Run two-stage review (spec compliance + code quality) |
| `analyzeFeature` | Check spec/plan/tasks consistency |
| `explainModule` | Get Mermaid dependency diagram |
| `verify` | Run full verification pipeline |

## Host Delegation

When running inside a host agent (Claude Code, Codex) without an API key, AI-dependent tools return structured `DelegationPrompt` objects for the host to process natively.

## License

Apache-2.0
npm package: @mainahq/skills
Description: Maina skills — cross-platform integration for Claude Code, Cursor, Codex, and Gemini CLI
Latest version: 1.1.2

# Maina Skills

Drop these into your AI agent's skills directory to get maina's verification workflow.

Each skill follows a standard format with frontmatter metadata (name, description, triggers) and progressive disclosure: scan the description in under 100 tokens, read the full skill in under 5000 tokens.

## Available Skills

| Skill | Description |
|-------|-------------|
| `verification-workflow` | Full verify pipeline: syntax guard, parallel tools, diff-only filter |
| `context-generation` | 4-layer context retrieval with dynamic token budgets |
| `plan-writing` | Spec-first planning with consistency validation |
| `code-review` | Two-stage review: spec compliance then code quality |
| `tdd` | Test-driven development from generated stubs |

## Installation

### Claude Code

Copy skill directories to your project or reference via plugin. Claude Code will detect SKILL.md files and use their triggers to activate the appropriate workflow.

### Cursor

Add skill content to `.cursorrules` or reference in settings. The frontmatter triggers help Cursor match user intent to the right workflow.

### Codex

Reference SKILL.md files in `AGENTS.md`. Codex agents will follow the step-by-step instructions when triggered.

### Gemini CLI

Include skill content in your project's context files. Gemini CLI reads the triggers and steps to guide its workflow.