@uluops/setup 0.2.0 → 0.6.0

package/assets/{commands → claude-code/commands}/agents/type-safety.md

@@ -1,135 +1,156 @@
----
-name: type-safety
-description: Run Type Safety Validator on TypeScript projects. Validates beyond tsc—catches any abuse, unsafe assertions, type holes that pass compilation but cause runtime failures.
----
-
-# Type Safety Validator
-Run Type Safety Validator on TypeScript projects. Validates beyond tsc—catches any abuse, unsafe assertions, type holes that pass compilation but cause runtime failures.
-
-## Arguments
-
-**Usage:** `/agents:type-safety <directory>`
-
-**Examples:**
-- `/agents:type-safety ./src`
-- `/agents:type-safety ./packages/api`
-- `/agents:type-safety .`
-
-**Target Directory:** $ARGUMENTS
-
----
-
-## Pre-Flight
-
-```bash
-echo "Running type safety validation on $ARGUMENTS..."
-echo "==============================================="
-```
-
-Verify the target directory exists:
-
-```bash
-test -d "$ARGUMENTS" && echo "✓ Directory exists: $ARGUMENTS" || echo "ERROR: Directory '$ARGUMENTS' not found"
-```
-
-Enter and confirm location:
-
-```bash
-cd "$ARGUMENTS" && pwd
-```
-
-Check path exists:
-
-```bash
-[ -e "$ARGUMENTS" ] && echo "✓ $ARGUMENTS exists" || echo "Target directory does not exist"
-```
-
-
----
-
-## Agent Invocation
-
-Run the Type Safety Validator agent on the validated target directory:
-
-**Agent:** type-safety-validator-agent.md
-**Model:** Sonnet
-**Target:** $ARGUMENTS
-
-The agent performs code quality validation across 5 categories (100 points total):
-
-| Category | Points | Focus |
-|----------|--------|-------|
-| Any Usage | 25 | Tracks explicit any, implicit any, and any isolation at boundaries |
-| Type Assertions | 25 | Validates safe use of as casts, non-null assertions, and suppressions |
-| Strict Mode Compliance | 20 | Validates strictNullChecks patterns, optional handling, union narrowing |
-| Generic & Complex Types | 15 | Validates generic constraints, type complexity, utility type usage |
-| Export Type Quality | 15 | Validates public API type accuracy, explicitness, and consumer safety |
-
----
-
-## Auto-Fail Conditions
-
-Critical issues that trigger immediate FAIL regardless of score:
-
-| ID | Condition |
-|----|-----------|
-| **AF-001** | any in exported function signatures |
-| **AF-002** | Double assertions (as unknown as Type) |
-| **AF-003** | @ts-ignore on security/auth code without justification |
-| **AF-004** | strict: false in tsconfig for library code |
-| **AF-005** | Non-null assertions on untrusted/external data |
-
----
-
-## Decision Thresholds
-
-| Score | Decision | Meaning |
-|-------|----------|---------|
-| **>=80** | ✅ PASS | Validation passed, proceed to next phase |
-| **<80** | ❌ FAIL | Validation failed, fix issues before proceeding |
-
-**Note:** Any critical issue triggers FAIL regardless of score.
-
----
-
-
-## PERSIST TO TRACKER (Required)
-
-> **IMPORTANT:** Save to tracker IMMEDIATELY after agent completes, BEFORE presenting the summary to the user. The workflow is not complete until results are persisted.
-**1. Get token metrics from buffer:**
-```bash
-agent-metrics buffer list --since 5m -f tracker
-```
-
-**2. Save to tracker (DO THIS FIRST):**
-
-mcp__uluops-tracker__save_features_list
-
-**3. Verify saved:** Compare `json.summary.total_issues` with saved count.
-
-**4. THEN present summary to user.**
-
-### Field Mappings
-
-**From JSON OUTPUT to Tracker:**
-| Source | Tracker Field | Notes |
-|--------|---------------|-------|
-| `json.result.score` | `validators[].score` | Total score |
-| `json.result.decision` | `validators[].status` | PASS/FAIL |
-| `buffer.model` | `validators[].model` | From agent-metrics buffer |
-| `buffer.tokens.input_tokens` | `input_tokens` | Raw input tokens |
-| `buffer.tokens.output_tokens` | `output_tokens` | Output tokens |
-| `buffer.tokens.cache_creation_tokens` | `cache_creation_tokens` | Cache creation |
-| `buffer.tokens.cache_read_tokens` | `cache_read_tokens` | Cache reads |
-| `buffer.tokens.total_effective_tokens` | `total_effective_tokens` | Effective total |
-| `json.categories[].findings[].issues[]` | `recommendations[]` | Flatten nested structure |
-
-**Note:** `json` = agent's JSON OUTPUT, `buffer` = `agent-metrics buffer list -f tracker`
-
----
-
-## Source
-
-**CDL Schema:** `udl/definition-languages/cdl-schema-v1.1.0.json`
-**CDL Source:** `/home/alexs/uluops/uluops-agent-workflows/udl/cdl/v1/type-safety.command.yaml`
-**Agent:** `agents/type-safety-validator-agent.md`
+---
+name: type-safety
+description: Run Type Safety Validator on TypeScript projects. Validates beyond tsc—catches any abuse, unsafe assertions, type holes that pass compilation but cause runtime failures.
+---
+
+# Type Safety Validator v1
+Run Type Safety Validator on TypeScript projects. Validates beyond tsc—catches any abuse, unsafe assertions, type holes that pass compilation but cause runtime failures.
+
+## What's New in v1
+
+| Feature | Description |
+|---------|-------------|
+| **Calibration Examples** | Reference scenarios for consistent scoring |
+| **Failure Code Examples** | Worked examples mapping issues to taxonomy codes |
+| **Token Budget** | Output length guidance |
+| **Display IDs** | Auto-fail conditions have numbered IDs |
+
+## Arguments
+
+**Usage:** `/agents:type-safety <directory>`
+
+**Examples:**
+- `/agents:type-safety ./src`
+- `/agents:type-safety ./packages/api`
+- `/agents:type-safety .`
+
+**Target Directory:** $ARGUMENTS
+
+
+---
+
+## Pre-Flight
+
+```bash
+echo "Running type safety validation on $ARGUMENTS..."
+echo "==============================================="
+```
+
+Verify the target directory exists:
+
+```bash
+test -d "$ARGUMENTS" && echo "✓ Directory exists: $ARGUMENTS" || echo "ERROR: Directory '$ARGUMENTS' not found"
+```
+
+Enter and confirm location:
+
+```bash
+cd "$ARGUMENTS" && pwd
+```
+
+Check path exists:
+
+```bash
+[ -e "$ARGUMENTS" ] && echo "✓ $ARGUMENTS exists" || echo "Target directory does not exist"
+```
+
+
+---
+
+## Agent Invocation
+
+Run the Type Safety Validator agent on the validated target directory:
+
+**Agent:** type-safety-validator-agent.md
+**Model:** Sonnet
+**Target:** $ARGUMENTS
+
+
+---
+
+## Decision Thresholds
+
+| Score | Decision | Meaning |
+|-------|----------|---------|
+| **>=80** | ✅ PASS | Validation passed, proceed to next phase |
+| **<80** | ❌ FAIL | Validation failed, fix issues before proceeding |
+
+**Note:** Any critical issue triggers FAIL regardless of score.
+
+---
+
+## Post-Flight Actions
+
+### On Success
+
+Type safety validation passed with score >= 80
+
+```bash
+exit 0
+```
+
+### On Failure
+
+Type safety validation failed. Review issues above.
+
+```bash
+exit 1
+```
+
+
+---
+
+
+## PERSIST TO TRACKER (Required)
+
+> **IMPORTANT:** Save to tracker IMMEDIATELY after agent completes, BEFORE presenting the summary to the user. The workflow is not complete until results are persisted.
+**1. Get token metrics from buffer:**
+```bash
+agent-metrics buffer list --since 5m -f tracker
+```
+
+**2. Save to tracker (DO THIS FIRST):**
+
+mcp__uluops-tracker__save_run
+
+**3. Verify saved:** Compare `json.summary.total_issues` with saved count.
+
+**4. THEN present summary to user.**
+
+### Field Mappings
+
+**Definition identity (REQUIRED for execution tracking):**
+| Tracker Field | Value | Notes |
+|---------------|-------|-------|
+| `definition_type` | `command` | From CDL interface |
+| `definition_name` | `type-safety` | From CDL interface |
+| `definition_version` | `1.0.2` | From CDL interface |
+
+**From JSON OUTPUT to Tracker:**
+| Source | Tracker Field | Notes |
+|--------|---------------|-------|
+| `json.result.score` | `agents[].score` | Total score |
+| `json.result.decision` | `agents[].decision` | PASS/FAIL |
+| `buffer.model` | `validators[].model` | From agent-metrics buffer |
+| `buffer.tokens.input_tokens` | `input_tokens` | Raw input tokens |
+| `buffer.tokens.output_tokens` | `output_tokens` | Output tokens |
+| `buffer.tokens.cache_creation_tokens` | `cache_creation_tokens` | Cache creation |
+| `buffer.tokens.cache_read_tokens` | `cache_read_tokens` | Cache reads |
+| `buffer.tokens.total_effective_tokens` | `total_effective_tokens` | Effective total |
+| `json.categories[].findings[].issues[]` | `recommendations[]` | Flatten nested structure |
+| `json.analysis.records[]` | `analysis_records[]` | Structured analysis records (v1.4.0) |
+| `json.analysis.system_metrics` | `analysis_summary.system_metrics` | Agent-type-specific metrics |
+| `json.analysis.category_scores[]` | `analysis_summary.category_scores[]` | Category score breakdown |
+| `json.analysis.epistemic_assessment` | `analysis_summary.epistemic_assessment` | Failure signature risk ratings |
+| `json.analysis.audit_implications[]` | `analysis_summary.audit_implications[]` | Trajectory projections |
+
+**Note:** `json` = agent's JSON OUTPUT, `buffer` = `agent-metrics buffer list -f tracker`
+**Note:** `analysis_records` and `analysis_summary` are optional (v1.4.0). Omit if agent output has no `analysis` section.
+
+---
+
+## Source
+
+**CDL Schema:** `udl/definition-languages/cdl-schema-v1_3_0.json`
+**CDL Source:** `/Users/aself/uluops/uluops-agent-workflows/udl/cdl/v1/type-safety.command.yaml`
+**Agent:** `agents/type-safety-validator-agent.md`

package/assets/{commands → claude-code/commands}/agents/validate.md

@@ -1,134 +1,156 @@
----
-name: validate
-description: Validates code quality, standards compliance, and test coverage. Use after each implementation phase.
----
-
-# Code Validator
-Validates code quality, standards compliance, and test coverage. Use after each implementation phase.
-
-## Arguments
-
-**Usage:** `/agents:validate <directory>`
-
-**Examples:**
-- `/agents:validate ./services/auth-service`
-- `/agents:validate ./packages/api`
-- `/agents:validate .`
-
-**Target Directory:** $ARGUMENTS
-
----
-
-## Pre-Flight
-
-```bash
-echo "Running code validation on $ARGUMENTS..."
-echo "========================================"
-```
-
-Verify the target directory exists:
-
-```bash
-test -d "$ARGUMENTS" && echo "✓ Directory exists: $ARGUMENTS" || echo "ERROR: Directory '$ARGUMENTS' not found"
-```
-
-Enter and confirm location:
-
-```bash
-cd "$ARGUMENTS" && pwd
-```
-
-Check path exists:
-
-```bash
-[ -e "$ARGUMENTS" ] && echo "✓ $ARGUMENTS exists" || echo "Target directory does not exist"
-```
-
-
----
-
-## Agent Invocation
-
-Run the Code Validator agent on the validated target directory:
-
-**Agent:** code-validator-agent.md
-**Model:** Sonnet
-**Target:** $ARGUMENTS
-
-The agent performs code quality validation across 4 categories (100 points total):
-
-| Category | Points | Focus |
-|----------|--------|-------|
-| Code Quality | 30 | Function design, naming, duplication, error handling, complexity |
-| Standards Compliance | 25 | Style guide adherence, formatting, imports, documentation |
-| Testing | 25 | Unit tests, edge cases, behavior verification, test execution |
-| Best Practices | 20 | Security basics, performance, separation of concerns, dependencies |
-
----
-
-## Auto-Fail Conditions
-
-Critical issues that trigger immediate FAIL regardless of score:
-
-| ID | Condition |
-|----|-----------|
-| **AF-001** | Security vulnerabilities detected |
-| **AF-002** | Missing error handling in critical paths |
-| **AF-003** | Code does not function |
-| **AF-004** | Missing tests for core functionality |
-| **AF-005** | Breaking changes without migration path |
-
----
-
-## Decision Thresholds
-
-| Score | Decision | Meaning |
-|-------|----------|---------|
-| **>=70** | ✅ PASS | Validation passed, proceed to next phase |
-| **<70** | ❌ FAIL | Validation failed, fix issues before proceeding |
-
-**Note:** Any critical issue triggers FAIL regardless of score.
-
----
-
-
-## PERSIST TO TRACKER (Required)
-
-> **IMPORTANT:** Save to tracker IMMEDIATELY after agent completes, BEFORE presenting the summary to the user. The workflow is not complete until results are persisted.
-**1. Save to tracker (REQUIRED):**
-
-```bash
-agent-metrics buffer list --since 5m -f tracker
-```
-
-mcp__uluops-tracker__save_features_list
-
-**2. Verify saved:** Compare `json.summary.total_issues` with saved count.
-
-**3. THEN present summary to user.**
-
-
-### Field Mappings
-
-**From JSON OUTPUT to Tracker:**
-| Source | Tracker Field | Notes |
-|--------|---------------|-------|
-| `json.result.score` | `validators[].score` | Total score |
-| `json.result.decision` | `validators[].status` | PASS/FAIL |
-| `buffer.model` | `validators[].model` | From agent-metrics buffer |
-| `buffer.tokens.input_tokens` | `input_tokens` | Raw input tokens |
-| `buffer.tokens.output_tokens` | `output_tokens` | Output tokens |
-| `buffer.tokens.cache_creation_tokens` | `cache_creation_tokens` | Cache creation |
-| `buffer.tokens.cache_read_tokens` | `cache_read_tokens` | Cache reads |
-| `buffer.tokens.total_effective_tokens` | `total_effective_tokens` | Effective total |
-| `json.categories[].findings[].issues[]` | `recommendations[]` | Flatten nested structure |
-
-**Note:** `json` = agent's JSON OUTPUT, `buffer` = `agent-metrics buffer list -f tracker`
-
----
-
-## Source
-
-**CDL Schema:** `udl/definition-languages/cdl-schema-v1.1.0.json`
-**CDL Source:** `/home/alexs/uluops/uluops-agent-workflows/udl/cdl/v1/validate.command.yaml`
-**Agent:** `agents/code-validator-agent.md`
+---
+name: validate
+description: Validates code quality, standards compliance, and test coverage. Use after each implementation phase.
+---
+
+# Code Validator v1
+Validates code quality, standards compliance, and test coverage. Use after each implementation phase.
+
+## What's New in v1
+
+| Feature | Description |
+|---------|-------------|
+| **Calibration Examples** | Reference scenarios for consistent scoring |
+| **Failure Code Examples** | Worked examples mapping issues to taxonomy codes |
+| **Token Budget** | Output length guidance |
+| **Display IDs** | Auto-fail conditions have numbered IDs |
+
+## Arguments
+
+**Usage:** `/agents:validate <directory>`
+
+**Examples:**
+- `/agents:validate ./services/auth-service`
+- `/agents:validate ./packages/api`
+- `/agents:validate .`
+
+**Target Directory:** $ARGUMENTS
+
+
+---
+
+## Pre-Flight
+
+```bash
+echo "Running code validation on $ARGUMENTS..."
+echo "========================================"
+```
+
+Verify the target directory exists:
+
+```bash
+test -d "$ARGUMENTS" && echo "✓ Directory exists: $ARGUMENTS" || echo "ERROR: Directory '$ARGUMENTS' not found"
+```
+
+Enter and confirm location:
+
+```bash
+cd "$ARGUMENTS" && pwd
+```
+
+Check path exists:
+
+```bash
+[ -e "$ARGUMENTS" ] && echo "✓ $ARGUMENTS exists" || echo "Target directory does not exist"
+```
+
+
+---
+
+## Agent Invocation
+
+Run the Code Validator agent on the validated target directory:
+
+**Agent:** code-validator-agent.md
+**Model:** Sonnet
+**Target:** $ARGUMENTS
+
+
+---
+
+## Decision Thresholds
+
+| Score | Decision | Meaning |
+|-------|----------|---------|
+| **>=70** | ✅ PASS | Validation passed, proceed to next phase |
+| **<70** | ❌ FAIL | Validation failed, fix issues before proceeding |
+
+**Note:** Any critical issue triggers FAIL regardless of score.
+
+---
+
+## Post-Flight Actions
+
+### On Success
+
+Validation passed with score >= 70
+
+```bash
+exit 0
+```
+
+### On Failure
+
+Validation failed. Review issues above.
+
+```bash
+exit 1
+```
+
+
+---
+
+
+## PERSIST TO TRACKER (Required)
+
+> **IMPORTANT:** Save to tracker IMMEDIATELY after agent completes, BEFORE presenting the summary to the user. The workflow is not complete until results are persisted.
+**1. Save to tracker (REQUIRED):**
+
+```bash
+agent-metrics buffer list --since 5m -f tracker
+```
+
+mcp__uluops-tracker__save_run
+
+**2. Verify saved:** Compare `json.summary.total_issues` with saved count.
+
+**3. THEN present summary to user.**
+
+
+### Field Mappings
+
+**Definition identity (REQUIRED for execution tracking):**
+| Tracker Field | Value | Notes |
+|---------------|-------|-------|
+| `definition_type` | `command` | From CDL interface |
+| `definition_name` | `validate` | From CDL interface |
+| `definition_version` | `1.0.2` | From CDL interface |
+
+**From JSON OUTPUT to Tracker:**
+| Source | Tracker Field | Notes |
+|--------|---------------|-------|
+| `json.result.score` | `agents[].score` | Total score |
+| `json.result.decision` | `agents[].decision` | PASS/FAIL |
+| `buffer.model` | `validators[].model` | From agent-metrics buffer |
+| `buffer.tokens.input_tokens` | `input_tokens` | Raw input tokens |
+| `buffer.tokens.output_tokens` | `output_tokens` | Output tokens |
+| `buffer.tokens.cache_creation_tokens` | `cache_creation_tokens` | Cache creation |
+| `buffer.tokens.cache_read_tokens` | `cache_read_tokens` | Cache reads |
+| `buffer.tokens.total_effective_tokens` | `total_effective_tokens` | Effective total |
+| `json.categories[].findings[].issues[]` | `recommendations[]` | Flatten nested structure |
+| `json.analysis.records[]` | `analysis_records[]` | Structured analysis records (v1.4.0) |
+| `json.analysis.system_metrics` | `analysis_summary.system_metrics` | Agent-type-specific metrics |
+| `json.analysis.category_scores[]` | `analysis_summary.category_scores[]` | Category score breakdown |
+| `json.analysis.epistemic_assessment` | `analysis_summary.epistemic_assessment` | Failure signature risk ratings |
+| `json.analysis.audit_implications[]` | `analysis_summary.audit_implications[]` | Trajectory projections |
+
+**Note:** `json` = agent's JSON OUTPUT, `buffer` = `agent-metrics buffer list -f tracker`
+**Note:** `analysis_records` and `analysis_summary` are optional (v1.4.0). Omit if agent output has no `analysis` section.
+
+---
+
+## Source
+
+**CDL Schema:** `udl/definition-languages/cdl-schema-v1_3_0.json`
+**CDL Source:** `/Users/aself/uluops/uluops-agent-workflows/udl/cdl/v1/validate.command.yaml`
+**Agent:** `agents/code-validator-agent.md`