Package Exports

sentineltm-cli
sentineltm-cli/dist/index.js

This package does not declare an exports field, so the exports above have been automatically detected and optimized by JSPM instead. If any package subpath is missing, it is recommended to post an issue to the original package (sentineltm-cli) to support the "exports" field. If that is not possible, create a JSPM override to customize the exports field for this package.

Readme

🛡️ SentinelTM: The Ultimate AI-Powered Development Guardian

The World's Most Advanced AI Development Orchestrator
Enforce Zero Tolerance Quality Standards with Military-Grade Precision

Version 2.3.6 — Critical MCP workspace bug fixed! 🎉

SentinelTM (st) is a revolutionary AI-powered development guardian that transforms how you build software. Combining enterprise-grade CLI tools with cutting-edge MCP (Model Context Protocol) capabilities, it enforces uncompromising quality standards while seamlessly integrating with 20+ AI providers and 23+ IDEs.

✨ What Makes SentinelTM Different?

🎯 Zero Tolerance Quality: Enforces strict coding standards with AI-powered validation
🔐 Security-First: Sandboxed file system and controlled shell execution
🤖 Provider Agnostic: Works with Ollama, OpenAI, Claude, Gemini, Mistral, OpenRouter, and any OpenAI-compatible API
🚀 Interactive Setup: Guided configuration with smart defaults
📊 Quality Gates: Automated code review and compliance checking
🎨 IDE Integration: One-command setup for VS Code, Cursor, Zed, Windsurf, and more

🧹 Code Formatting & Linting (Built-in)

SentinelTM now ships built-in helpers to keep your codebase clean without extra setup.

Format (all/common languages)
- st fmt (auto-detect) or st fmt js|ts|py|go|rs|sh|md
Lint
- st lint (auto-detect) or st lint js|ts|py|sh
Python helpers (Ruff)
- st py init-config → creates pyproject.toml (and optional pre-commit)
- st py format → ruff format .
- st py lint → ruff check . --fix

Notes:

Tools are used if available (e.g., prettier, eslint, ruff, gofmt, rustfmt, shfmt). If not installed, helpful guidance is shown.
Minimal defaults, zero clutter. Use st init-config to generate minimal configs (.eslintrc.json, .prettierrc, pyproject.toml).

🚀 Quick Start (2 Minutes)

1️⃣ Install

npm install -g sentineltm-cli@latest

2️⃣ Configure Your AI Provider (Interactive)

SentinelTM provides an interactive setup wizard for seamless configuration:

st set provider

This will guide you through:

📋 Select Provider: Choose from Ollama, OpenAI, Claude, Gemini, Mistral, or OpenRouter
🔑 Enter API Key: Provide your API credentials (or skip for Ollama)
🤖 Select Model: Pick from available models (auto-fetched from the provider)

Example Providers:

Ollama (Local, Free)

# Install Ollama first: https://ollama.ai
ollama pull llama3

# Then configure
st set provider
# → Select: ollama
# → API Key: (leave blank)
# → Model: llama3

OpenRouter (Best for Production)

st set provider
# → Select: openrouter
# → API Key: sk-or-v1-xxxxx
# → Model: deepseek/deepseek-chat or x-ai/grok-2-latest

OpenAI

st set provider
# → Select: openai
# → API Key: sk-xxxxx
# → Model: gpt-4-turbo

3️⃣ Set Up IDE Integration (Interactive)

Configure your development environment with one command:

st set ide

This will:

✅ Select IDEs: Choose from VS Code, Cursor, Zed, Windsurf, Continue, Cline, etc.
🤖 Configure Provider: Select AI provider and model (if not already set)
📜 Apply Rules: Optionally apply Zero Tolerance coding standards

4️⃣ Verify Installation

# Check provider status
st provider status

# Run quality gate
st gate run

📚 Command Reference

🤖 Provider Management

Command	Description
`st set provider`	Interactive setup for AI provider (recommended)
`st provider configure`	Alternative interactive setup command
`st provider set <name>`	Set existing provider as default
`st provider list`	List available models from provider
`st provider status`	Show current provider and model
`st provider detect`	Auto-detect available providers

🎨 IDE Configuration

Command	Description
`st set ide`	Interactive IDE setup (recommended)
`st ide set [names...]`	Configure specific IDEs
`st ide list`	List all supported IDE targets

Supported IDEs: VS Code, Cursor, Zed, Windsurf, Continue, Cline, Codex, Claude, Gemini, OpenCode, Roo, Amp, Kilo, Trae, Kiro

✅ Quality Gates

Command	Description
`st gate run`	Run all quality checks
`st gate run --min 90`	Run with custom passing score

Built-in Checks:

🧪 Tests
🎨 Linting & Formatting
🏗️ Build Verification
🔒 Security Scan
📁 Project Structure
🧹 Code Hygiene
🤖 AI Rule Check (enforces Zero Tolerance standards)

📂 File System Operations

Command	Description
`st fs ls [path]`	List files and directories
`st fs read <path>`	Read file contents
`st fs write <path>`	Write to file
`st fs search <query>`	Search across codebase

🔍 Code Indexing

Command	Description
`st index build`	Build code index
`st index status`	Show index statistics
`st index search <query>`	Search indexed code

📊 Dashboard & Reporting

Command	Description
`st dashboard report`	Full project health report
`st dashboard metrics`	Key metrics summary
`st status`	Quick project overview

🛠️ Task Management

Command	Description
`st task list`	List all tasks
`st task add <title>`	Create new task
`st task done <id>`	Mark task as complete

🎯 Zero Tolerance Contract

SentinelTM enforces strict coding standards through its Zero Tolerance Contract system:

✅ Type safety and hints required
✅ No hardcoded values (strings, numbers, URLs)
✅ Configuration externalized to YAML
✅ Modular architecture (max 300 lines per file)
✅ PEP8/ESLint compliance
✅ Comprehensive error handling
✅ Security best practices

See ZERO_TOLERANCE_CONTRACT.md for full details.

🔧 Configuration

All configuration is stored in .sentineltm/config/config.json:

{
  "defaults": {
    "provider": "openrouter",
    "model": "deepseek/deepseek-chat"
  },
  "providers": {
    "openrouter": {
      "type": "openai-compatible",
      "baseURL": "https://openrouter.ai/api",
      "apiKey": "sk-or-v1-xxxxx"
    }
  }
}

📖 Advanced Guides

API Integration Guide - Deep dive into provider configuration
Zero Tolerance Contract - Complete coding standards
MCP Server Usage - Using SentinelTM as an MCP server

🆘 Troubleshooting

Provider not working?

st provider status    # Check configuration
st provider detect    # Auto-detect available providers

IDE configuration not applying?

st ide list          # Check supported IDEs
st set ide           # Re-run interactive setup

Quality gate failing?

st gate run --min 70  # Lower threshold for testing

🤝 Contributing

We welcome contributions! Please:

Fork the repository
Create a feature branch
Submit a pull request

sentineltm-cli