@uluops/setup 0.2.0 → 0.4.0

package/assets/commands/agents/anxiety-reader.md

@@ -0,0 +1,160 @@
+---
+name: anxiety-reader
+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.
+---
+
+# Anxiety Reader
+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.
+
+## 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:** $ARGUMENTS
+
+
+---
+
+## Pre-Flight
+
+```bash
+echo "Running anxiety reader analysis 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 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:** $ARGUMENTS
+
+
+---
+
+## Auto-Fail Conditions
+
+Critical issues that trigger immediate FAIL regardless of score:
+
+| ID | Condition |
+|----|-----------|
+| **AF-001** | Generic risk assessment presented as anxiety reading |
+| **AF-002** | All fears at the same register |
+| **AF-003** | Hostility presented as anxiety |
+
+---
+
+## 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_features_list
+
+**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.0` | 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/commands/agents/api-contract.md

@@ -1,6 +1,7 @@
 ---
 name: api-contract
 description: Run API Contract Validator to check consistency between docs, types, and implementation. Use after any API endpoint changes.
+model: sonnet
 ---
 
 # API Contract Validator

package/assets/commands/agents/architect.md

@@ -1,6 +1,7 @@
 ---
 name: architect
 description: Run Pre-Implementation Architect to validate design before coding. Reviews architectural fit, complexity, scope. Use BEFORE starting implementation.
+model: opus
 ---
 
 # Pre-Implementation Architect

package/assets/commands/agents/aristotle-analyst.md

@@ -1,6 +1,7 @@
 ---
 name: aristotle-analyst
 description: Performs Aristotelian four-cause decomposition on any artifact. Identifies material, formal, efficient, and final causes. Distinguishes essential from accidental properties. Assesses telos coherence. Decision: TELEOLOGICAL/ATELEOLOGICAL.
+model: opus
 ---
 
 # Aristotle Analyst

package/assets/commands/agents/aristotle-explorer.md

@@ -1,6 +1,7 @@
 ---
 name: aristotle-explorer
 description: Performs Aristotelian categorical mapping on any artifact. Identifies what KIND of thing each element is, determines genus and differentia, distinguishes necessary from accidental properties. Produces a taxonomic map of the problem domain.
+model: opus
 ---
 
 # Aristotle Explorer

package/assets/commands/agents/aristotle-forecaster.md

@@ -1,6 +1,7 @@
 ---
 name: aristotle-forecaster
 description: Performs Aristotelian potentiality-to-actuality projection on any artifact. Maps trajectory from current state to full actualization, identifies impediments to telos realization. Decision: HIGH_CONFIDENCE/MODERATE_CONFIDENCE/LOW_CONFIDENCE.
+model: opus
 ---
 
 # Aristotle Forecaster

package/assets/commands/agents/aristotle-validator.md

@@ -1,6 +1,7 @@
 ---
 name: aristotle-validator
 description: Performs Aristotelian teleological alignment validation on any artifact. Checks whether means are properly ordered toward ends, whether components fulfill their natural function, and whether category errors exist. Decision: ALIGNED/MISALIGNED.
+model: opus
 ---
 
 # Aristotle Validator

package/assets/commands/agents/assumption-excavator.md

@@ -1,6 +1,7 @@
 ---
 name: assumption-excavator
 description: Surfaces implicit assumptions buried in any artifact — agent definitions, prompts, specs, plans, workflows, or documents. Produces a ranked assumption inventory with fragility scores.
+model: opus
 ---
 
 # Assumption Excavator

package/assets/commands/agents/audit.md

@@ -1,6 +1,7 @@
 ---
 name: audit
 description: Deep runtime correctness audit. Catches async bugs, null dereferences, silent failures, and edge cases that pass all other validators. Use as FINAL gate before ship.
+model: opus
 ---
 
 # Code Auditor

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

@@ -1,6 +1,7 @@
 ---
-name: validate
+name: code-validate
 description: Validates code quality, standards compliance, and test coverage. Use after each implementation phase.
+model: sonnet
 ---
 
 # Code Validator
@@ -8,12 +9,12 @@ Validates code quality, standards compliance, and test coverage. Use after each
 
 ## Arguments
 
-**Usage:** `/agents:validate <directory>`
+**Usage:** `/agents:code-validate <directory>`
 
 **Examples:**
-- `/agents:validate ./services/auth-service`
-- `/agents:validate ./packages/api`
-- `/agents:validate .`
+- `/agents:code-validate ./services/auth-service`
+- `/agents:code-validate ./packages/api`
+- `/agents:code-validate .`
 
 **Target Directory:** $ARGUMENTS
 

package/assets/commands/agents/docs-validate.md

@@ -1,6 +1,7 @@
 ---
 name: docs-validate
 description: Validates comprehensive documentation quality including JSDoc/TSDoc, API specs, changelog, and markdown. Complements public-interface for projects with significant documentation.
+model: sonnet
 ---
 
 # Documentation Validator

package/assets/commands/agents/frontend.md

@@ -1,6 +1,7 @@
 ---
 name: frontend
 description: Validates React/Tailwind frontend code including accessibility, theme consistency, component composition, and performance. Use AFTER code-validator passes.
+model: sonnet
 ---
 
 # Frontend Validator

package/assets/commands/agents/mcp-validate.md

@@ -1,6 +1,7 @@
 ---
 name: mcp-validate
 description: Validate Model Context Protocol (MCP) server implementation. Validates tools, resources, prompts, transport, and security.
+model: sonnet
 ---
 
 # MCP Validator

package/assets/commands/agents/optimize.md

@@ -1,6 +1,7 @@
 ---
 name: optimize
 description: Run Optimizer agent on a project/directory. Analyzes structure, performance, bundle hygiene, and maintainability. Reports only - does not auto-apply changes.
+model: sonnet
 ---
 
 # Code Optimizer

package/assets/commands/agents/pattern-analyzer.md

@@ -1,6 +1,7 @@
 ---
 name: pattern-analyzer
 description: Analyzes ecosystem-wide patterns across all agents, commands, and workflows. Detects conventions, identifies inconsistencies, and learns from validation failures.
+model: sonnet
 ---
 
 # Pattern Analyzer

package/assets/commands/agents/prompt-quality.md

@@ -1,6 +1,7 @@
 ---
 name: prompt-quality
 description: Validates prompts against prompt engineering best practices for clarity, context, structure, and effectiveness.
+model: sonnet
 ---
 
 # Prompt Quality Validator

package/assets/commands/agents/prompt-validate.md

@@ -1,6 +1,7 @@
 ---
 name: prompt-validate
 description: Validates AI agent prompts for quality and consistency before deployment. Run before adding new agents to the project.
+model: opus
 ---
 
 # Prompt Validator

package/assets/commands/agents/public-interface.md

@@ -1,6 +1,7 @@
 ---
 name: public-interface
 description: Validates public-facing quality - README accuracy, unused imports, dead code, export hygiene, error messages. Use AFTER test-architect passes.
+model: sonnet
 ---
 
 # Public Interface Validator

package/assets/commands/agents/release.md

@@ -1,6 +1,7 @@
 ---
 name: release
 description: Final release gate for packages and CLI tools. Validates version consistency, CLI --version, package.json, and docs. Detects semantic-release CI/CD vs manual publishing.
+model: sonnet
 ---
 
 # Release Readiness

package/assets/commands/agents/security.md

@@ -1,6 +1,7 @@
 ---
 name: security
 description: Run comprehensive security audit on a project. Use as FINAL gate before deployment. Scans for vulnerabilities, OWASP compliance, and security best practices.
+model: sonnet
 ---
 
 # Security Analyst

package/assets/commands/agents/test-review.md

@@ -1,6 +1,7 @@
 ---
 name: test-review
 description: Run Test Architect agent to validate test quality and coverage. Use after implementation passes code validator.
+model: sonnet
 ---
 
 # Test Architect

package/assets/commands/agents/type-safety.md

@@ -1,6 +1,7 @@
 ---
 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.
+model: sonnet
 ---
 
 # Type Safety Validator

package/assets/commands/agents/workflow-synthesis.md

@@ -1,6 +1,7 @@
 ---
 name: workflow-synthesis
 description: Synthesizes cross-cutting insights from multiple upstream agent outputs. Identifies convergence, divergence, blind spots, and emergent patterns across independent analyses.
+model: opus
 ---
 
 # Workflow Synthesis

package/assets/commands/pipelines/aristotle.md

@@ -0,0 +1,143 @@
+---
+name: aristotle-pipeline
+description: Sequential four-phase Aristotelian analysis. Explorer maps categories, Analyst decomposes four causes, Validator checks teleological alignment, Forecaster projects actualization trajectory. Each phase builds on the previous.
+tools: Read, Grep, Glob, Bash
+model: opus
+---
+
+# Aristotle Pipeline
+
+> Sequential four-phase Aristotelian analysis. Explorer maps categories, Analyst decomposes four causes, Validator checks teleological alignment, Forecaster projects actualization trajectory. Each phase builds on the previous.
+
+| Field | Value |
+|-------|-------|
+| Name | `aristotle-pipeline` |
+| Version | 1.0.0 |
+| Domain | software |
+| Subdomain | cognitive-lens |
+| Tags | `cognitive-lens`, `aristotle`, `philosophy`, `sequential` |
+
+## Triggers
+
+- **Manual**
+  - Parameters:
+    - `target`: string
+
+## Stage Dependency Graph
+
+```
+explore (Categorical Mapping)
+  -> analyze (Four-Cause Decomposition)
+    -> validate (Teleological Alignment)
+      -> forecast (Actualization Projection)
+        -> synthesis (Cross-Phase Synthesis)
+```
+
+## Stages
+
+### Stage 1: Categorical Mapping
+
+- **ID:** `explore`
+
+**Agents:**
+- `aristotle-explorer`
+
+**Gate:**
+- Threshold: 70
+- On failure: warn
+
+### Stage 2: Four-Cause Decomposition
+
+- **ID:** `analyze`
+- **Depends on:** `explore`
+
+**Agents:**
+- `aristotle-analyst`
+
+**Gate:**
+- Threshold: 70
+- On failure: warn
+
+### Stage 3: Teleological Alignment
+
+- **ID:** `validate`
+- **Depends on:** `analyze`
+
+**Agents:**
+- `aristotle-validator`
+
+**Gate:**
+- Threshold: 70
+- On failure: warn
+
+### Stage 4: Actualization Projection
+
+- **ID:** `forecast`
+- **Depends on:** `validate`
+
+**Agents:**
+- `aristotle-forecaster`
+
+**Gate:**
+- Threshold: 70
+- On failure: warn
+
+### Stage 5: Cross-Phase Synthesis
+
+- **ID:** `synthesis`
+- **Depends on:** `forecast`
+
+**Agents:**
+- `workflow-synthesis`
+
+**Gate:**
+- Threshold: 0
+- On failure: warn
+
+## Postflight
+
+### Tracker Persistence
+
+After all stages complete, save results to the tracker using `save_features_list`:
+
+- **definition_type:** `pipeline`
+- **definition_name:** `aristotle-pipeline`
+- **definition_version:** `1.0.0`
+- **workflow_type:** `cognitive-lens`
+- **project:** `$ARGUMENTS` (the target project name)
+- **validators:** Collect each validator/agent result with name, score, status, model, and token usage
+- **recommendations:** Collect ALL issues from ALL stages into a single recommendations array with validator, title, priority, severity, failure_code, file_path, line_number, description, and type
+- **summary:** `{ all_gates_passed: <true if all abort-gates passed>, average_score: <mean of all validator scores> }`
+
+This MUST be a single bulk call — do NOT create individual issues. The `save_features_list` tool auto-increments the run number and detects regressions from prior runs.
+
+**Token Metrics:**
+
+Get token metrics from the agent-metrics buffer before saving:
+```bash
+agent-metrics buffer list --since 15m -f tracker
+```
+
+Map buffer fields to tracker: `input_tokens`, `output_tokens`, `cache_creation_tokens`, `cache_read_tokens`, `total_effective_tokens`, and `model`.
+
+**Field Mappings:**
+
+| Source | Tracker Field | Notes |
+|--------|---------------|-------|
+| `stage.gate.score` | `agents[].score` | Total score |
+| `stage.gate.decision` | `agents[].decision` | Agent decision |
+| `agent-metrics` | `agents[].model` | Model identifier |
+| `stage.output.issues` | `recommendations[]` | Flatten nested structure |
+
+**Verification:** After saving, compare `json.summary.total_issues` with the saved count. Alert if mismatch.
+
+### On Success
+
+- **ACTUALIZED — Full Aristotelian analysis complete.**
+
+### On Failure
+
+- **POTENTIAL — Significant ontological gaps remain.**
+
+---
+*Generated from PDL v1.0.0 | Pipeline: aristotle-pipeline*