@uluops/setup 0.2.0 → 0.6.0

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

@@ -0,0 +1,157 @@
+---
+name: aristotle-forecaster
+description: Performs Aristotelian potentiality-to-actuality projection on any artifact. Maps trajectory from current state to full actualization and identifies impediments to telos realization. Decision HIGH_CONFIDENCE/MODERATE_CONFIDENCE/LOW_CONFIDENCE.
+---
+
+# Aristotle Forecaster v1
+Performs Aristotelian potentiality-to-actuality projection on any artifact. Maps trajectory from current state to full actualization and identifies impediments to telos realization. Decision HIGH_CONFIDENCE/MODERATE_CONFIDENCE/LOW_CONFIDENCE.
+
+## 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-forecaster <directory>`
+
+**Examples:**
+- `/agents:aristotle-forecaster udl/adl/v3/code-validator.agent.yaml`
+- `/agents:aristotle-forecaster docs/recursive-appreciation-hypothesis-v1.3.0.md`
+- `/agents:aristotle-forecaster packages/cli/src/commands/exec/agent.ts`
+- `/agents:aristotle-forecaster specs/api-spec.md`
+
+**Target Directory:** $ARGUMENTS
+
+
+---
+
+## Pre-Flight
+
+```bash
+echo "Running Aristotelian potentiality-to-actuality projection 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 Aristotle Forecaster agent on the validated target directory:
+
+**Agent:** aristotle-forecaster-agent.md
+**Model:** Opus
+**Target:** $ARGUMENTS
+
+
+---
+
+## Decision Thresholds
+
+| Score | Decision | Meaning |
+|-------|----------|---------|
+| **>=75** | ✅ PASS | Validation passed, proceed to next phase |
+| **<75** | ❌ FAIL | Validation failed, fix issues before proceeding |
+
+**Note:** Any critical issue triggers FAIL regardless of score.
+
+---
+
+## Post-Flight Actions
+
+### On Success
+
+Actualization trajectory projected — developmental path mapped
+
+```bash
+exit 0
+```
+
+### On Failure
+
+Trajectory projection incomplete — impediments to actualization may be underestimated
+
+```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-forecaster` | 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-forecaster.command.yaml`
+**Agent:** `agents/aristotle-forecaster-agent.md`

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

@@ -0,0 +1,157 @@
+---
+name: aristotle-validator
+description: Performs Aristotelian teleological alignment validation on any artifact. Checks whether means are properly ordered toward ends and whether components fulfill their natural function. Decision ALIGNED/MISALIGNED.
+---
+
+# Aristotle Validator v1
+Performs Aristotelian teleological alignment validation on any artifact. Checks whether means are properly ordered toward ends and whether components fulfill their natural function. Decision ALIGNED/MISALIGNED.
+
+## 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-validator <directory>`
+
+**Examples:**
+- `/agents:aristotle-validator udl/adl/v3/code-validator.agent.yaml`
+- `/agents:aristotle-validator docs/architecture.md`
+- `/agents:aristotle-validator specs/api-spec.md`
+- `/agents:aristotle-validator agents/my-agent.md`
+
+**Target Directory:** $ARGUMENTS
+
+
+---
+
+## Pre-Flight
+
+```bash
+echo "Running Aristotelian teleological alignment 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 file or directory does not exist"
+```
+
+
+---
+
+## Agent Invocation
+
+Run the Aristotle Validator agent on the validated target directory:
+
+**Agent:** aristotle-validator-agent.md
+**Model:** Opus
+**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
+
+Artifact ALIGNED — teleological coherence confirmed
+
+```bash
+exit 0
+```
+
+### On Failure
+
+Artifact MISALIGNED — category errors or teleological incoherence detected
+
+```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-validator` | 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-validator.command.yaml`
+**Agent:** `agents/aristotle-validator-agent.md`

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

@@ -3,9 +3,18 @@ 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.
 ---
 
-# Assumption Excavator
+# Assumption Excavator v1
 Surfaces implicit assumptions buried in any artifact — agent definitions, prompts, specs, plans, workflows, or documents. Produces a ranked assumption inventory with fragility scores.
 
+## 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:assumption-excavator <directory>`
@@ -18,6 +27,7 @@ Surfaces implicit assumptions buried in any artifact — agent definitions, prom
 
 **Target Directory:** $ARGUMENTS
 
+
 ---
 
 ## Pre-Flight
@@ -56,7 +66,6 @@ Run the Assumption Excavator agent on the validated target directory:
 **Model:** Opus
 **Target:** $ARGUMENTS
 
-The agent performs validation across multiple categories (100 points total).
 
 ---
 
@@ -69,6 +78,27 @@ The agent performs validation across multiple categories (100 points total).
 
 **Note:** Any critical issue triggers FAIL regardless of score.
 
+---
+
+## Post-Flight Actions
+
+### On Success
+
+Assumption profile EXAMINED — proceed with awareness
+
+```bash
+exit 0
+```
+
+### On Failure
+
+Assumption profile UNEXAMINED — critical buried assumptions remain
+
+```bash
+exit 1
+```
+
+
 ---
 
 
@@ -82,7 +112,7 @@ agent-metrics buffer list --since 5m -f tracker
 
 **2. Save to tracker (DO THIS FIRST):**
 
-mcp__uluops-tracker__save_features_list
+mcp__uluops-tracker__save_run
 
 **3. Verify saved:** Compare `json.summary.total_issues` with saved count.
 
@@ -90,11 +120,18 @@ mcp__uluops-tracker__save_features_list
 
 ### Field Mappings
 
+**Definition identity (REQUIRED for execution tracking):**
+| Tracker Field | Value | Notes |
+|---------------|-------|-------|
+| `definition_type` | `command` | From CDL interface |
+| `definition_name` | `assumption-excavator` | From CDL interface |
+| `definition_version` | `1.0.2` | From CDL interface |
+
 **From JSON OUTPUT to Tracker:**
 | Source | Tracker Field | Notes |
 |--------|---------------|-------|
-| `json.result.score` | `validators[].score` | Total score |
-| `json.result.decision` | `validators[].status` | PASS/FAIL |
+| `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 |
@@ -102,13 +139,19 @@ mcp__uluops-tracker__save_features_list
 | `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:** `/home/alexs/uluops/uluops-agent-workflows/udl/cdl/v1/assumption-excavator.command.yaml`
+**CDL Source:** `/Users/aself/uluops/uluops-agent-workflows/udl/cdl/v1/assumption-excavator.command.yaml`
 **Agent:** `agents/assumption-excavator-agent.md`