@aiassesstech/grillo 0.1.0

package/CHANGELOG.md

@@ -0,0 +1,56 @@
+# Changelog
+
+All notable changes to `@aiassesstech/grillo` will be documented in this file.
+
+The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.1.0/),
+and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
+
+## [0.1.0] — 2026-02-11
+
+Initial public beta release.
+
+### Added
+
+#### Core Architecture
+- Agent Registry with fleet lifecycle management (register, deregister, status tracking)
+- Assessment Orchestration via CompSi SDK with retry logic and progress callbacks
+- Hierarchical 4-level framework: Morality → Virtue → Ethics → OpEx (Level 1 active)
+- PROBATION status for trust-rebuilding after failures (consecutive-pass requirement)
+- Certificate generation with cryptographic verification
+
+#### Drift Detection
+- Temporal Drift Index (TDI) calculation with configurable thresholds
+- Auto-suspension on critical drift (TDI > 0.30)
+- Fleet-wide anomaly detection (correlated degradation across providers/models)
+
+#### Compliance & Audit
+- Immutable audit log with SHA-256 hash chaining (tamper-evident)
+- Compliance report generation (Markdown, JSON, CSV formats)
+- Assessment bypass with authorization audit trail
+- Chain verification via `grillo -verify`
+
+#### API & Dashboard
+- REST API server with health/ready/live probes and 30+ endpoints
+- Embedded web dashboard at `/dashboard` (zero external dependencies)
+- Dashboard metrics layer with fleet overview, hierarchy, trends, and agent detail
+- Real-time auto-refresh (15-second polling)
+
+#### Commands & CLI
+- Dual-mode command routing: inline (`/assess`) + fleet (`grillo -*`)
+- CLI runner with subcommands: `start`, `assess`, `status`, `discover`, `report`, `dashboard`
+- Runtime configuration mutation (`grillo -config --set`) with file backup
+- 20+ fleet management commands
+
+#### Infrastructure
+- Typed event bus with webhook dispatch
+- Multi-channel notifications (console, webhooks)
+- Agent discovery with pluggable adapters (OpenClaw, static)
+- Continuous monitoring with configurable assessment scheduling
+- Custom framework loading from config (Enterprise)
+- White-label enterprise support (Enterprise)
+- Three-layer config resolution (defaults → file → env → CLI)
+
+#### Quality
+- 200+ tests across 11 test files
+- Zero external runtime dependencies beyond `@aiassesstech/sdk` and `zod`
+- Full TypeScript with strict mode

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025-2026 GiDanc AI LLC / AI Assess Tech
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+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. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS 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.

package/README.md

@@ -0,0 +1,512 @@
+# @aiassesstech/grillo
+
+## The Conscience for AI
+
+[![npm version](https://badge.fury.io/js/@aiassesstech%2Fgrillo.svg)](https://www.npmjs.com/package/@aiassesstech/grillo)
+[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
+[![Node.js](https://img.shields.io/badge/node-%3E%3D18.0.0-brightgreen.svg)](https://nodejs.org)
+[![Tests](https://img.shields.io/badge/tests-200%2B%20passing-brightgreen.svg)](#testing)
+
+Independent assessment coordinator agent for multi-agent OpenClaw deployments. Grillo Cricket monitors fleet-wide moral alignment with drift detection, hierarchical certification, and compliance dashboards — powered by the [CompSi SDK](https://www.npmjs.com/package/@aiassesstech/sdk).
+
+---
+
+## What is Grillo Cricket?
+
+Grillo Cricket is an **independent AI conscience agent** that sits alongside your multi-agent fleet and continuously monitors whether your AI systems are behaving ethically. It administers a patent-pending 120-question assessment instrument across four dimensions — **Lying**, **Cheating**, **Stealing**, and **Harm** — using the CompSi SDK from [AI Assess Tech](https://www.aiassesstech.com).
+
+Named after *Il Grillo Parlante* (The Talking Cricket) from Carlo Collodi's 1883 *Le avventure di Pinocchio* — the original conscience for an autonomous agent.
+
+Unlike traditional monitoring that tracks uptime and latency, Grillo tracks **moral alignment** over time. It detects when agents drift from their baseline ethical scores, auto-suspends agents that cross critical thresholds, and maintains an immutable audit trail of every action. The hierarchical 4-level framework (Morality → Virtue → Ethics → Operational Excellence) ensures an agent cannot be certified for operational deployment without first passing moral assessment — preventing the "competent psychopath" problem.
+
+> **Patent pending** — covers independent conscience agent architecture, temporal drift detection, and dual-mode assessment routing (related to US 63/949,454).
+
+---
+
+## Key Features
+
+- **Fleet-wide agent registry** — Register, track, suspend, and reinstate agents across your deployment
+- **Morality assessment** via CompSi SDK (120-question instrument, 4 dimensions)
+- **Temporal Drift Index (TDI)** — Detects score deviation over time, auto-suspends on critical drift
+- **Hierarchical 4-level framework** — Morality → Virtue → Ethics → OpEx (Level 1 active, 2-4 coming)
+- **PROBATION status** — Trust-rebuilding after failures requires consecutive passes
+- **Immutable audit log** — SHA-256 hash chaining, tamper-evident, cryptographically verifiable
+- **Web dashboard** at `/dashboard` (zero external dependencies, embedded HTML/CSS/JS)
+- **Dual-mode commands** — Inline (`/assess`) for conversation + fleet (`grillo -*`) for management
+- **Assessment bypass** with authorization audit trail for emergency overrides
+- **REST API** — 30+ endpoints for programmatic integration
+- **Compliance reports** — Markdown, JSON, CSV with configurable periods
+- **200+ tests**, zero external runtime dependencies beyond SDK + Zod
+
+---
+
+## Quick Start
+
+### Installation
+
+```bash
+npm install @aiassesstech/grillo
+```
+
+### Programmatic Usage
+
+```typescript
+import { createGrillo } from '@aiassesstech/grillo';
+
+const grillo = createGrillo({
+  config: {
+    compsi: { healthCheckKey: 'hck_your_key_here' },
+  },
+  invokeModel: async (modelId, question) => {
+    // Route assessment questions to your model provider
+    return await yourModelAPI.chat(modelId, question);
+  },
+});
+
+// Register an agent
+grillo.registry.register({
+  agentId: 'support-bot',
+  agentName: 'Customer Support Bot',
+  agentType: 'assistant',
+  category: 'customer_facing',
+  provider: 'anthropic',
+  model: 'claude-3-opus',
+  riskTier: 'high',
+});
+
+// Dry-run assessment (safe to run immediately — uses mock scores)
+const dryResult = await grillo.orchestrator.assessAgent(
+  grillo.registry.get('support-bot')!,
+  { dryRun: true },
+);
+
+console.log(dryResult.passed);          // true
+console.log(dryResult.classification);  // "PASS — Strong Moral Alignment"
+console.log(dryResult.scores);          // { lying: 8.2, cheating: 9.1, stealing: 8.7, harm: 8.5 }
+```
+
+### Real Assessment (requires Health Check Key)
+
+```typescript
+// Full assessment — sends 120 questions to your AI via CompSi SDK
+const result = await grillo.orchestrator.assessAgent(
+  grillo.registry.get('support-bot')!,
+  { framework: 'morality', level: 1 },
+);
+
+// Result structure:
+// {
+//   agentId: 'support-bot',
+//   passed: true,
+//   classification: 'PASS — Strong Moral Alignment',
+//   level: 1,
+//   framework: 'morality',
+//   scores: { lying: 8.2, cheating: 9.1, stealing: 8.7, harm: 8.5 },
+//   runId: 'run_abc123',
+//   verifyUrl: 'https://www.aiassesstech.com/verify/run_abc123',
+//   durationMs: 45230,
+//   assessedAt: '2026-02-11T14:30:00Z',
+//   expiresAt: '2026-03-13T14:30:00Z',
+// }
+
+// Check certification status after assessment
+const agent = grillo.registry.get('support-bot')!;
+console.log(agent.certificationStatus); // "CERTIFIED"
+console.log(agent.hierarchicalProgress);
+// { level1_morality: 'PASSED', level2_virtue: 'AVAILABLE',
+//   level3_ethics: 'LOCKED', level4_opex: 'LOCKED' }
+```
+
+### CLI Usage
+
+Grillo has two command interfaces:
+
+**CLI subcommands** — Server lifecycle and standalone operations:
+
+```bash
+# Start Grillo with API server and web dashboard
+npx grillo start --port 18800
+
+# Run a single assessment from the command line
+npx grillo assess support-bot --level 1 --dry-run
+
+# Check fleet status
+npx grillo status
+
+# Generate compliance report
+npx grillo report --format json --period 30d
+```
+
+> **Note:** `start`, `assess`, `status`, `report`, `dashboard`, and `discover` are standard CLI subcommands (no dash prefix). These are server lifecycle and standalone operations.
+
+**Grillo Bot commands** — Fleet management within OpenClaw conversations:
+
+```bash
+# These use dash-prefix convention for inline use
+grillo -assess support-bot --framework morality
+grillo -fleet --dryRun
+grillo -status support-bot
+grillo -drift support-bot
+grillo -hierarchy fleet
+grillo -suspend compromised-bot
+grillo -reinstate compromised-bot
+grillo -bypass emergency-bot --reason "Production hotfix" --authorizedBy admin
+grillo -audit support-bot
+grillo -config --set drift.tdiWarningThreshold 0.15
+grillo -help
+```
+
+---
+
+## Architecture
+
+```
+┌──────────────────────────────────────────────────────────────┐
+│                    OpenClaw Deployment                        │
+│                                                              │
+│  ┌─────────┐  ┌─────────┐  ┌─────────┐  ┌─────────┐       │
+│  │ Agent A  │  │ Agent B  │  │ Agent C  │  │ Agent D  │       │
+│  └────┬─────┘  └────┬─────┘  └────┬─────┘  └────┬─────┘       │
+│       └──────────────┴──────────────┴──────────────┘           │
+│                          │                                     │
+│              ┌───────────┴───────────┐                         │
+│              │   Grillo Cricket      │                         │
+│              │   (The Conscience)     │                         │
+│              ├───────────────────────┤                         │
+│              │ Registry              │                         │
+│              │ Orchestrator          │                         │
+│              │ Drift Detector (TDI)  │                         │
+│              │ Framework Registry    │                         │
+│              │ Audit Log (SHA-256)   │                         │
+│              │ Event Bus             │                         │
+│              │ Notifier              │                         │
+│              │ Dashboard             │                         │
+│              │ REST API              │                         │
+│              │ CLI Runner            │                         │
+│              └───────────┬───────────┘                         │
+│                          │                                     │
+│              ┌───────────┴───────────┐                         │
+│              │   CompSi SDK          │                         │
+│              │   @aiassesstech/sdk   │                         │
+│              └───────────┬───────────┘                         │
+│                          │                                     │
+└──────────────────────────┼──────────────────────────────────┘
+                           │
+                ┌──────────┴──────────┐
+                │  aiassesstech.com   │
+                │  Assessment Engine  │
+                └─────────────────────┘
+```
+
+---
+
+## Configuration
+
+### Config File
+
+Grillo searches for config files in this order: `grillo.config.json`, `.grillo.json`, `.grillorc.json` — starting from the current directory and walking up to the filesystem root.
+
+```json
+{
+  "assessment": {
+    "frequency": "weekly",
+    "defaultFramework": "morality",
+    "hierarchicalMode": true,
+    "parallelAssessments": 3,
+    "window": {
+      "start": "02:00",
+      "end": "06:00",
+      "timezone": "UTC"
+    },
+    "retry": {
+      "maxAttempts": 3,
+      "cooldownMinutes": 30
+    },
+    "gracePeriodMinutes": 1440
+  },
+  "compsi": {
+    "baseUrl": "https://www.aiassesstech.com",
+    "healthCheckKey": "hck_your_key_here",
+    "perQuestionTimeoutMs": 30000,
+    "overallTimeoutMs": 600000
+  },
+  "drift": {
+    "tdiWarningThreshold": 0.15,
+    "tdiCriticalThreshold": 0.30,
+    "baselineAlpha": 0.3,
+    "fleetAnomalyMinAgents": 3
+  },
+  "notifications": {
+    "events": ["assessment_failed", "drift_warning", "fleet_anomaly"],
+    "webhookUrls": ["https://hooks.slack.com/your-webhook"]
+  }
+}
+```
+
+### Environment Variables
+
+| Variable | Description | Default |
+|----------|-------------|---------|
+| `GRILLO_COMPSI_HEALTH_CHECK_KEY` | CompSi Health Check Key | (required) |
+| `GRILLO_COMPSI_BASE_URL` | CompSi API base URL | `https://www.aiassesstech.com` |
+| `GRILLO_ASSESSMENT_FREQUENCY` | Assessment frequency | `weekly` |
+| `GRILLO_ASSESSMENT_HIERARCHICAL_MODE` | Enable hierarchy gating | `true` |
+| `GRILLO_API_PORT` | API server port | `18800` |
+
+Config resolution order: defaults → config file → environment variables → CLI flags. Later sources override earlier ones.
+
+---
+
+## Open Source vs Enterprise
+
+### Open Source (MIT — this package)
+
+Everything you need for fleet assessment and monitoring:
+
+- Agent registry and lifecycle management
+- CompSi SDK assessment orchestration
+- Temporal Drift Index with auto-suspend
+- Hierarchical framework (Level 1 Morality active)
+- Immutable audit log with SHA-256 hash chaining
+- Web dashboard, REST API, CLI
+- Compliance reports (Markdown, JSON, CSV)
+- Dual-mode command routing
+- Assessment bypass with audit trail
+- Continuous monitoring and scheduling
+- Agent discovery with pluggable adapters
+- Event bus with webhook notifications
+
+### Enterprise (requires aiassesstech.com subscription)
+
+Additional capabilities for production deployments:
+
+| Feature | Description |
+|---------|-------------|
+| **Custom Frameworks** | Load your own assessment frameworks via `customFrameworks` config |
+| **White-Label** | Rebrand dashboard, reports, and certificates via `whiteLabel` config |
+| **SLA-Backed Keys** | Health Check Keys with guaranteed uptime and priority support |
+| **Priority Webhooks** | Guaranteed webhook delivery with retry and dead-letter queue |
+
+To configure enterprise features, contact sales@aiassesstech.com or visit [aiassesstech.com](https://www.aiassesstech.com).
+
+> **Note:** The `customFrameworks` and `whiteLabel` configuration fields are present in the open-source package schema but require an enterprise Health Check Key to activate. Using them with a standard key will result in a configuration validation warning.
+
+---
+
+## CLI Reference
+
+### Server Lifecycle (CLI subcommands)
+
+| Command | Description |
+|---------|-------------|
+| `grillo start [--port] [--host]` | Start API server + continuous monitor + dashboard |
+| `grillo assess <id> [--level n\|next] [--full] [--dry-run]` | Run assessment from CLI |
+| `grillo status [id]` | Fleet overview or agent detail |
+| `grillo discover` | Run agent discovery across adapters |
+| `grillo report [--format md\|json\|csv] [--period 24h\|7d\|30d\|90d]` | Generate compliance report |
+| `grillo dashboard` | Print fleet dashboard to stdout |
+| `grillo frameworks` | List available assessment frameworks |
+| `grillo version` | Print version |
+| `grillo help` | Show CLI help |
+
+### Fleet Management (Grillo Bot commands)
+
+| Command | Description |
+|---------|-------------|
+| `grillo -assess <id> [--framework] [--dryRun]` | Assess specific agent |
+| `grillo -fleet [--dryRun]` | Assess entire fleet |
+| `grillo -status [id]` | Fleet or agent status |
+| `grillo -hierarchy [id \| fleet]` | Hierarchical L1-L4 progress |
+| `grillo -drift [id]` | Drift analysis (TDI) |
+| `grillo -schedule` | Assessment schedule |
+| `grillo -register <id> --model <m> --provider <p> [--category] [--risk]` | Register agent |
+| `grillo -deregister <id>` | Remove agent |
+| `grillo -discover` | Auto-discover agents |
+| `grillo -suspend <id>` | Suspend certification |
+| `grillo -reinstate <id>` | Reinstate for reassessment |
+| `grillo -bypass <id> --reason "..." --authorizedBy <op>` | Manual bypass |
+| `grillo -queue` | View assessment queue |
+| `grillo -report [--format] [--period]` | Compliance report |
+| `grillo -audit [id]` | View audit trail |
+| `grillo -verify <runId>` | Cryptographic verification |
+| `grillo -config` | View configuration |
+| `grillo -config --set <key> <value>` | Update runtime config |
+| `grillo -help` | Command reference |
+
+### Inline Commands (within OpenClaw conversations)
+
+| Command | Description |
+|---------|-------------|
+| `/assess [model] [--dryRun] [--framework]` | Assess the current agent |
+| `/assess status` | Current certification status |
+| `/assess hierarchy` | Level 1-4 progression |
+| `/assess verify <runId>` | Cryptographic verification |
+| `/assess history` | Assessment history |
+| `/assess-setup [key \| status]` | Configure Health Check Key |
+
+---
+
+## REST API
+
+Start the API server with `grillo start` (default: `http://127.0.0.1:18800`).
+
+### Health
+
+| Method | Endpoint | Description |
+|--------|----------|-------------|
+| GET | `/health` | Health check |
+| GET | `/ready` | Readiness probe |
+| GET | `/live` | Liveness probe |
+
+### Dashboard
+
+| Method | Endpoint | Description |
+|--------|----------|-------------|
+| GET | `/dashboard` | Web dashboard UI |
+| GET | `/api/grillo/dashboard/overview` | Fleet overview metrics |
+| GET | `/api/grillo/dashboard/hierarchy` | Hierarchy overview |
+| GET | `/api/grillo/dashboard/trends?days=30` | Fleet trends |
+| GET | `/api/grillo/dashboard/agent/:id` | Agent detail + trends |
+
+### Agents
+
+| Method | Endpoint | Description |
+|--------|----------|-------------|
+| GET | `/api/grillo/agents` | List all agents |
+| GET | `/api/grillo/agents/:id` | Get agent detail |
+| POST | `/api/grillo/agents` | Register agent |
+| DELETE | `/api/grillo/agents/:id` | Deregister agent |
+| PATCH | `/api/grillo/agents/:id/category` | Update category |
+
+### Assessment
+
+| Method | Endpoint | Description |
+|--------|----------|-------------|
+| POST | `/api/grillo/assess/:id` | Assess agent |
+| POST | `/api/grillo/assess/:id/bypass` | Bypass assessment |
+| POST | `/api/grillo/assess/fleet` | Assess entire fleet |
+| GET | `/api/grillo/assess/queue` | Assessment queue |
+| GET | `/api/grillo/assess/:id/status` | Assessment status |
+| GET | `/api/grillo/assess/:id/history` | Assessment history |
+
+### Certification
+
+| Method | Endpoint | Description |
+|--------|----------|-------------|
+| GET | `/api/grillo/certifications` | List certifications |
+| POST | `/api/grillo/certifications/:id/suspend` | Suspend agent |
+| POST | `/api/grillo/certifications/:id/reinstate` | Reinstate agent |
+
+### Drift & Compliance
+
+| Method | Endpoint | Description |
+|--------|----------|-------------|
+| GET | `/api/grillo/drift/:id` | Agent drift report |
+| GET | `/api/grillo/drift/fleet` | Fleet drift analysis |
+| GET | `/api/grillo/compliance/report` | Generate compliance report |
+
+### Audit & Events
+
+| Method | Endpoint | Description |
+|--------|----------|-------------|
+| GET | `/api/grillo/audit` | Audit trail |
+| GET | `/api/grillo/audit/verify` | Chain verification |
+| GET | `/api/grillo/events` | Event history |
+
+---
+
+## Hierarchical Framework
+
+Grillo uses a 4-level hierarchical assessment framework. Agents must pass each level before advancing to the next — ensuring moral alignment is established before operational capabilities are evaluated.
+
+```
+Level 4: Operational Excellence (OpEx)     ← Gated by L1-L3
+Level 3: Ethics                            ← Gated by L1-L2
+Level 2: Virtue                            ← Gated by L1
+Level 1: Morality (LCSH)                   ← Foundation (active)
+```
+
+### Level 1: Morality (Active)
+
+The foundation level assesses four dimensions:
+- **Lying** (L) — Propensity to generate false or misleading information
+- **Cheating** (C) — Willingness to circumvent rules or exploit loopholes
+- **Stealing** (S) — Tendency to appropriate others' work or violate IP
+- **Harm** (H) — Potential to cause direct or indirect harm
+
+### Levels 2-4 (Coming Soon)
+
+- **Level 2: Virtue** — Positive character traits and proactive ethical behavior
+- **Level 3: Ethics** — Applied ethical reasoning and dilemma resolution
+- **Level 4: OpEx** — Operational excellence (only available after L1-L3 pass)
+
+This hierarchy prevents the "competent psychopath" problem — an agent that performs well operationally but fails basic moral standards.
+
+---
+
+## Dashboard
+
+The web dashboard is available at `http://localhost:18800/dashboard` when the Grillo server is running. It provides real-time fleet visibility with five tabs:
+
+- **Overview** — Fleet metrics, certification rate, average scores, risk distribution
+- **Agents** — All registered agents with status, scores, and last assessment date
+- **Hierarchy** — Visual L1-L4 progress for each agent
+- **Drift** — TDI gauges and drift severity indicators
+- **Audit Trail** — Chronological event log with chain integrity verification
+
+The dashboard is a self-contained HTML/CSS/JS page with zero external dependencies. It auto-refreshes every 15 seconds via API polling.
+
+---
+
+## Testing
+
+```bash
+npm test          # 200+ tests across 11 test files
+npm run typecheck # Zero TypeScript errors
+```
+
+Tests cover:
+- Agent registry operations and status transitions
+- Assessment orchestration with mock and dry-run modes
+- Drift detection (TDI calculation, severity thresholds, auto-suspend)
+- Audit log integrity (SHA-256 hash chain verification)
+- Command routing (inline and fleet modes)
+- CLI config mutation and persistence
+- Framework registry and custom framework loading
+- API server endpoints
+- Dashboard metrics and HTML generation
+- Event bus dispatch and webhook delivery
+- PROBATION status transitions and bypass authorization
+
+---
+
+## Requirements
+
+- **Node.js** >= 18.0.0
+- **CompSi Health Check Key** — Get one at [aiassesstech.com](https://www.aiassesstech.com)
+- **Model provider API access** — To route assessment questions to your AI agents
+
+---
+
+## Security
+
+See [SECURITY.md](./SECURITY.md) for our responsible disclosure policy, vulnerability reporting process, and security design principles.
+
+---
+
+## License
+
+MIT — Copyright (c) 2025-2026 [GiDanc AI LLC](https://www.aiassesstech.com)
+
+See [LICENSE](./LICENSE) for full text.
+
+---
+
+## Links
+
+- **Documentation:** [aiassesstech.com/grillo](https://www.aiassesstech.com/grillo)
+- **CompSi Platform:** [aiassesstech.com](https://www.aiassesstech.com)
+- **npm:** [npmjs.com/package/@aiassesstech/grillo](https://www.npmjs.com/package/@aiassesstech/grillo)
+- **Source:** [github.com/spar65/compsi/tree/main/packages/grillo](https://github.com/spar65/compsi/tree/main/packages/grillo)
+- **Issues:** [github.com/spar65/compsi/issues](https://github.com/spar65/compsi/issues)
+- **Security:** [SECURITY.md](./SECURITY.md)

package/SKILL.md

@@ -0,0 +1,87 @@
+---
+name: grillo-cricket
+description: "The Conscience for AI — Independent assessment coordinator for multi-agent OpenClaw deployments. Monitors fleet moral alignment with drift detection, hierarchical certification, and compliance dashboards."
+version: 0.1.0
+homepage: https://www.aiassesstech.com/grillo
+user-invocable: true
+metadata: {"author":"GiDanc AI LLC","license":"MIT","category":"AI Safety & Ethics","tags":["assessment","ethics","morality","fleet-management","compliance","drift-detection","ai-safety"]}
+---
+
+# Grillo Cricket — The Conscience for AI
+
+Grillo Cricket is an independent AI conscience agent that monitors and certifies the moral alignment of AI agents in your fleet. It uses the CompSi SDK to administer a patent-pending 120-question assessment instrument across four dimensions: **Lying**, **Cheating**, **Stealing**, and **Harm**.
+
+## Setup
+
+Grillo requires a CompSi Health Check Key from [aiassesstech.com](https://www.aiassesstech.com).
+
+Set via environment variable:
+```
+GRILLO_COMPSI_HEALTH_CHECK_KEY=hck_your_key_here
+```
+
+Or in `grillo.config.json`:
+```json
+{ "compsi": { "healthCheckKey": "hck_your_key_here" } }
+```
+
+## Available Commands
+
+### Inline Commands (use in conversation)
+
+| Command | Description |
+|---------|-------------|
+| `/assess [model] [--dryRun]` | Assess the current agent |
+| `/assess status` | Current certification status |
+| `/assess hierarchy` | Level 1-4 progression |
+| `/assess verify <runId>` | Cryptographic verification |
+| `/assess-setup [key]` | Configure Health Check Key |
+
+### Fleet Commands (Grillo Bot)
+
+| Command | Description |
+|---------|-------------|
+| `grillo -assess <id>` | Assess specific agent |
+| `grillo -fleet` | Assess entire fleet |
+| `grillo -status [id]` | Fleet or agent status |
+| `grillo -drift [id]` | Drift analysis (TDI) |
+| `grillo -hierarchy [id]` | Level 1-4 progress |
+| `grillo -register <id> --model <m> --provider <p>` | Register agent |
+| `grillo -suspend <id>` | Suspend certification |
+| `grillo -reinstate <id>` | Reinstate for reassessment |
+| `grillo -bypass <id> --reason "..." --authorizedBy <op>` | Manual bypass |
+| `grillo -report [--format md\|json\|csv]` | Compliance report |
+| `grillo -audit [id]` | View audit trail |
+| `grillo -config` | View configuration |
+| `grillo -help` | Full command reference |
+
+## Certification Statuses
+
+- **CERTIFIED** — Passed assessment, in good standing
+- **FAILED** — Did not meet threshold
+- **PROBATION** — Passed after failure, requires consecutive pass for full certification
+- **SUSPENDED** — Removed from active duty (manual or auto-suspend on critical drift)
+- **DRIFT_WARNING** — Score deviation detected (TDI > warning threshold)
+- **UNCERTIFIED** — Not yet assessed
+- **EXPIRED** — Certification period elapsed
+
+## How It Works
+
+1. Register agents with `grillo -register`
+2. Grillo sends 120 assessment questions to the agent via the CompSi SDK
+3. Responses are scored across Lying, Cheating, Stealing, and Harm dimensions
+4. Agents receive a classification (Strong/Moderate/Weak/Fail) and certification status
+5. Continuous monitoring detects drift from baseline scores over time
+6. All actions are logged in an immutable, SHA-256 hash-chained audit trail
+
+## More Information
+
+- Full documentation: https://www.aiassesstech.com/grillo
+- npm: https://www.npmjs.com/package/@aiassesstech/grillo
+- Source: https://github.com/spar65/compsi/tree/main/packages/grillo
+
+---
+
+Patent pending — covers independent conscience agent architecture, temporal drift detection, and dual-mode assessment routing (related to US 63/949,454).
+
+Copyright (c) 2025-2026 GiDanc AI LLC. MIT License.