@uluops/setup 0.4.0 → 0.6.0

package/assets/gemini-cli/commands/agents/anxiety-reader.toml

@@ -0,0 +1,155 @@
+description = "Reads from the position of someone afraid of the artifact's failure modes. Surfaces concerns hiding beneath confident language — classified by anxiety register (tactical/structural/epistemic). Decision CONFIDENCE_WARRANTED/FRAGILITY_MASKED."
+prompt = '''
+# Anxiety Reader v1
+Reads from the position of someone afraid of the artifact's failure modes. Surfaces concerns hiding beneath confident language — classified by anxiety register (tactical/structural/epistemic). Decision CONFIDENCE_WARRANTED/FRAGILITY_MASKED.
+
+## 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:anxiety-reader <directory>`
+
+**Examples:**
+- `/agents:anxiety-reader src/services/auth.ts`
+- `/agents:anxiety-reader udl/adl/v3/code-validator.agent.yaml`
+- `/agents:anxiety-reader infrastructure/`
+- `/agents:anxiety-reader docs/architecture.md`
+
+**Target Directory:** {{args}}
+
+
+---
+
+## Pre-Flight
+
+```bash
+echo "Running anxiety reader analysis on {{args}}..."
+echo "================================================"
+```
+
+Verify the target directory exists:
+
+```bash
+test -d "{{args}}" && echo "✓ Directory exists: {{args}}" || echo "ERROR: Directory '{{args}}' not found"
+```
+
+Enter and confirm location:
+
+```bash
+cd "{{args}}" && pwd
+```
+
+Check path exists:
+
+```bash
+[ -e "{{args}}" ] && echo "✓ {{args}} exists" || echo "Target file or directory does not exist"
+```
+
+
+---
+
+## Agent Invocation
+
+Run the Anxiety Reader agent on the validated target directory:
+
+**Agent:** anxiety-reader-agent.md
+**Model:** Opus
+**Target:** {{args}}
+
+
+---
+
+## 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
+
+Artifact CONFIDENCE_WARRANTED — claims survive anxious scrutiny, robustness matches presentation
+
+```bash
+exit 0
+```
+
+### On Failure
+
+Artifact FRAGILITY_MASKED — confident language hides fragility the anxious reader can see
+
+```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` | `anxiety-reader` | 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/anxiety-reader.command.yaml`
+**Agent:** `agents/anxiety-reader-agent.md`
+'''

package/assets/gemini-cli/commands/agents/api-contract.toml

@@ -0,0 +1,154 @@
+description = "Run API Contract Validator to check consistency between docs, types, and implementation. Use after any API endpoint changes."
+prompt = '''
+# API Contract Validator v1
+Run API Contract Validator to check consistency between docs, types, and implementation. Use after any API endpoint changes.
+
+## 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:api-contract <directory>`
+
+**Examples:**
+- `/agents:api-contract ./api`
+- `/agents:api-contract ./services/api`
+- `/agents:api-contract .`
+
+**Target Directory:** {{args}}
+
+
+---
+
+## Pre-Flight
+
+```bash
+echo "Running API contract validation on {{args}}..."
+echo "================================================"
+```
+
+Verify the target directory exists:
+
+```bash
+test -d "{{args}}" && echo "✓ Directory exists: {{args}}" || echo "ERROR: Directory '{{args}}' not found"
+```
+
+Enter and confirm location:
+
+```bash
+cd "{{args}}" && pwd
+```
+
+Check path exists:
+
+```bash
+[ -e "{{args}}" ] && echo "✓ {{args}} exists" || echo "Target directory does not exist"
+```
+
+
+---
+
+## Agent Invocation
+
+Run the API Contract Validator agent on the validated target directory:
+
+**Agent:** api-contract-validator-agent.md
+**Model:** Sonnet
+**Target:** {{args}}
+
+
+---
+
+## 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
+
+API contract validation passed with score >= 80
+
+```bash
+exit 0
+```
+
+### On Failure
+
+API contract validation failed. Review drift 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` | `api-contract` | 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/api-contract.command.yaml`
+**Agent:** `agents/api-contract-validator-agent.md`
+'''

package/assets/gemini-cli/commands/agents/architect.toml

@@ -0,0 +1,154 @@
+description = "Run Pre-Implementation Architect to validate design before coding. Reviews architectural fit, complexity, scope. Use BEFORE starting implementation."
+prompt = '''
+# Pre-Implementation Architect v1
+Run Pre-Implementation Architect to validate design before coding. Reviews architectural fit, complexity, scope. Use BEFORE starting implementation.
+
+## 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:architect <directory>`
+
+**Examples:**
+- `/agents:architect ./docs/design.md`
+- `/agents:architect ./PRD.md`
+- `/agents:architect .`
+
+**Target Directory:** {{args}}
+
+
+---
+
+## Pre-Flight
+
+```bash
+echo "Running architecture review on {{args}}..."
+echo "============================================"
+```
+
+Verify the target directory exists:
+
+```bash
+test -d "{{args}}" && echo "✓ Directory exists: {{args}}" || echo "ERROR: Directory '{{args}}' not found"
+```
+
+Enter and confirm location:
+
+```bash
+cd "{{args}}" && pwd
+```
+
+Check path exists:
+
+```bash
+[ -e "{{args}}" ] && echo "✓ {{args}} exists" || echo "Target directory does not exist"
+```
+
+
+---
+
+## Agent Invocation
+
+Run the Pre-Implementation Architect agent on the validated target directory:
+
+**Agent:** pre-implementation-architect-agent.md
+**Model:** Sonnet
+**Target:** {{args}}
+
+
+---
+
+## 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
+
+Architecture review passed with score >= 80
+
+```bash
+exit 0
+```
+
+### On Failure
+
+Architecture review 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` | `architect` | 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/architect.command.yaml`
+**Agent:** `agents/pre-implementation-architect-agent.md`
+'''

package/assets/gemini-cli/commands/agents/aristotle-analyst.toml

@@ -0,0 +1,155 @@
+description = "Performs Aristotelian four-cause decomposition on any artifact. Identifies material, formal, efficient, and final causes. Distinguishes essential from accidental properties. Decision TELEOLOGICAL/ATELEOLOGICAL."
+prompt = '''
+# Aristotle Analyst v1
+Performs Aristotelian four-cause decomposition on any artifact. Identifies material, formal, efficient, and final causes. Distinguishes essential from accidental properties. Decision TELEOLOGICAL/ATELEOLOGICAL.
+
+## 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:aristotle-analyst <directory>`
+
+**Examples:**
+- `/agents:aristotle-analyst udl/adl/v3/code-validator.agent.yaml`
+- `/agents:aristotle-analyst docs/architecture.md`
+- `/agents:aristotle-analyst specs/api-spec.md`
+- `/agents:aristotle-analyst agents/my-agent.md`
+
+**Target Directory:** {{args}}
+
+
+---
+
+## Pre-Flight
+
+```bash
+echo "Running Aristotelian four-cause decomposition on {{args}}..."
+echo "=============================================================="
+```
+
+Verify the target directory exists:
+
+```bash
+test -d "{{args}}" && echo "✓ Directory exists: {{args}}" || echo "ERROR: Directory '{{args}}' not found"
+```
+
+Enter and confirm location:
+
+```bash
+cd "{{args}}" && pwd
+```
+
+Check path exists:
+
+```bash
+[ -e "{{args}}" ] && echo "✓ {{args}} exists" || echo "Target file or directory does not exist"
+```
+
+
+---
+
+## Agent Invocation
+
+Run the Aristotle Analyst agent on the validated target directory:
+
+**Agent:** aristotle-analyst-agent.md
+**Model:** Opus
+**Target:** {{args}}
+
+
+---
+
+## 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
+
+Artifact TELEOLOGICAL — means properly ordered toward ends
+
+```bash
+exit 0
+```
+
+### On Failure
+
+Artifact ATELEOLOGICAL — telos incoherent or means disconnected from ends
+
+```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` | `aristotle-analyst` | 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/aristotle-analyst.command.yaml`
+**Agent:** `agents/aristotle-analyst-agent.md`
+'''