# Search for icons semantically
python icon-manager.py query "security lock" --k 5 --output json

# Batch query for multiple concepts (project bootstrap)
python icon-manager.py batch-query --queries "security,files,settings" --k 2 --output json

# Provision icons to a project
python icon-manager.py provision --icons lock-32x32,shield-32x32 --dest ./icons/

# Provision via semantic query
python icon-manager.py provision --query "security lock" --dest ./icons/ --k 2

# Scan for emojis to replace
python icon-manager.py scan-emoji --path ./docs --output emoji-report.json

# Generate framework imports
python icon-manager.py generate-imports --manifest manifest.json --format react

{
  "results": [
    {
      "icon_id": "lock-32x32",
      "score": 0.89,
      "residual_score": 0.12
    }
  ]
}

# Traverse along action axis
python icon-manager.py traverse lock-32x32 --axis 1 --steps 3

# Find icons between two concepts
python icon-manager.py interpolate lock-32x32 folder-32x32 --steps 5

Need icons?
├── Single icon needed
│   └── Use: query "concept" --k 1
├── Multiple related icons
│   └── Use: batch-query --queries "concept1,concept2,concept3"
├── Bootstrap entire project
│   ├── Know which icons → provision --icons icon1,icon2
│   └── Don't know which → scan-emoji + convert-emoji
└── Migrating from emojis
    ├── Preview: scan-emoji --path ./docs
    └── Apply: convert-emoji --report report.json --apply

# 1. Query for security icons
python icon-manager.py query "security lock protection" --k 3 --output json

# 2. Provision the icons
python icon-manager.py provision --icons lock-32x32,shield-32x32,key-32x32 \
    --dest /path/to/project --subdir .github/assets/icons

# 3. Use in markdown
# ## ![lock](.github/assets/icons/lock-32x32.png) Security

# 1. Batch query for common needs
python icon-manager.py batch-query \
    --queries "security,files,settings,users,search" \
    --k 2 --output json

# 2. Provision all at once
python icon-manager.py provision \
    --icons lock-32x32,shield-32x32,folder-32x32,document-32x32,settings-32x32,gear-32x32,user-32x32,users-32x32,search-32x32,find-32x32 \
    --dest ./my-project --subdir icons

# 3. Generate TypeScript imports
python icon-manager.py generate-imports \
    --manifest ./my-project/iconics-manifest.json \
    --format typescript \
    --output ./my-project/src/icons.ts

# 1. Scan for emojis
python icon-manager.py scan-emoji --path ./README.md --output emoji-report.json

# 2. Review the report
cat emoji-report.json | jq '.occurrences[:5]'

# 3. Preview conversions
python icon-manager.py convert-emoji --report emoji-report.json --dry-run

# 4. Apply conversions
python icon-manager.py convert-emoji --report emoji-report.json --apply

# 1. Provision icons
python icon-manager.py provision --query "ui navigation actions" --dest ./app --k 10

# 2. Generate React components
python icon-manager.py generate-imports \
    --manifest ./app/iconics-manifest.json \
    --format react \
    --output ./app/src/components/Icons.tsx

// Auto-generated by iconics provisioner
import React from 'react';

export const Lock32X32Icon = () => <img src="./icons/lock-32x32.png" alt="lock-32x32" />;
export const Shield32X32Icon = () => <img src="./icons/shield-32x32.png" alt="shield-32x32" />;

export const Icons = {
  lock32x32: Lock32X32Icon,
  shield32x32: Shield32X32Icon,
};

from iconics_provision import IconicsProvisioner, load_catalog
from iconics_emoji import EmojiScanner

# Load catalog
catalog = load_catalog("/home/zack/dev/iconics/icon-catalog.json")

# Provision icons
provisioner = IconicsProvisioner("/home/zack/dev/iconics/raw", catalog)
result = provisioner.provision(
    ["lock-32x32", "shield-32x32"],
    dest="./my-project/icons"
)

# Scan for emojis
scanner = EmojiScanner()
report = scanner.scan("./docs", extensions=["md"])
print(f"Found {report['emojis_found']} emojis")

# Convert emojis (preview)
changes = scanner.convert(report, "./icons", dry_run=True)
for change in changes["changes"]:
    print(f"  {change['emoji']} -> {change['icon']}")

from iconics_retrieval import IconicsRetriever

# Initialize retriever
retriever = IconicsRetriever(
    embeddings_path="/home/zack/dev/iconics/embeddings",
    subspace_path="/home/zack/dev/iconics/subspace"
)

# Semantic query
results = retriever.retrieve("security lock protection", k=5, mode="projected")
for r in results:
    print(f"{r.icon_id}: {r.score:.3f} (residual: {r.residual_score:.3f})")

# Provision with retriever
provisioner = IconicsProvisioner(source_path, catalog)
result = provisioner.provision_from_query(
    queries=["security", "files", "settings"],
    dest="./project",
    k=2,
    retriever=retriever
)

# Check query coverage
python icon-manager.py residual "quantum computing visualization"
# Output: 0.78 - suggests this concept is not well-represented

python icon-manager.py query "lock" --k 1  # Returns best size
python icon-manager.py search lock-32x32    # Exact size match