pa-score-importance

# pa-score-importance

Analyze and score the importance of a message for memory prioritization. Examines text to extract importance level from 0.0 (trivial) to 1.0 (critical) based on factual content, preferences, and explicit memory requests.

## Installation

This is a CmdForge tool. It should be installed in your CmdForge tools directory (`~/.cmdforge/pa-score-importance/`) with a wrapper script in `~/.local/bin/pa-score-importance`.

## Usage

This tool accepts input via stdin (pipe):

```bash
# Score a user message
echo "Remember my birthday is March 15th" | pa-score-importance

# Score conversational text
echo "The weather is nice today" | pa-score-importance

# Use in a pipeline with other tools
cat message.txt | pa-score-importance | jq '.importance'
```

## Arguments

This tool takes no command-line arguments. All input is provided via stdin.

## How It Works

1. **LLM Analysis (score_message)**: Sends the input text to Claude Sonnet to analyze importance based on:
   - Factual content (names, dates, preferences)
   - Explicit memory requests ("remember this")
   - Personal significance vs. casual conversation
   
2. **Parse and Validate (parse_and_validate)**: Extracts the numeric importance score from the LLM response and validates it's within the 0.0-1.0 range.

The tool returns structured output containing the importance score, suitable for integration into memory prioritization systems.

## Dependencies

None. This tool operates independently.