domus-inventory: CLI, Integration & Implementation

CLI Usage

# Query
inv list                           # All active items
inv list --category electronics    # Filter by category
inv list --location office         # Where is it?
inv list --value-above 500         # High-value items
inv list --warranty-expiring 90    # Expiring in 90 days
inv list --maintenance-due         # Needs attention

# Reports
inv report insurance               # Insurance inventory
inv report depreciation 2026       # Tax depreciation schedule
inv report location                # Room-by-room inventory
inv report value                   # Total asset value

# Management
inv add                            # Interactive add
inv edit ELEC-001                  # Edit item
inv move ELEC-001 --location "office/desk"
inv maintain ELEC-001 --task "Clean fans"
inv dispose ELEC-001 --method sold --value 1200

# Utilities
inv qr ELEC-001                    # Generate QR code
inv search "razer"                 # Full-text search

Integration Points

gopass

receipt: "gopass://v3/personal/receipts/item-name"
warranty_details: "gopass://v3/personal/warranties/item-name"
access_code: "gopass://v3/personal/storage/unit-name"

Worklog

== Acquisitions
* Purchased Sony WH-1000XM5 ($348)
  ** Added to inventory: `inv add` → ELEC-094
  ** Receipt stored: `gopass insert v3/personal/receipts/sony-xm5`

Maintenance Cron

# Daily check for maintenance due
0 9 * * * inv list --maintenance-due --format reminder | mail -s "Maintenance Due" evan

Implementation Phases

Phase 1: Schema & CLI (Week 1)

  • Create data/inventory.yml with schema

  • Create scripts/inv CLI tool

  • Add 20 high-value items as proof of concept

  • Test query patterns

Phase 2: Views & Reports (Week 2)

  • Create AsciiDoc pages that render from YAML

  • Implement insurance report generator

  • Implement depreciation calculator

  • Add to nav.adoc under Reference

Phase 3: Physical Integration (Week 3)

  • QR code generator

  • Print labels for high-value items

  • Photo documentation workflow

  • Receipt digitization backlog

Phase 4: Automation (Week 4)

  • Maintenance reminder cron job

  • Warranty expiration alerts

  • Annual insurance report auto-generation

  • Backup to gopass

Success Metrics

Metric Target Purpose

Items tracked

200+

Comprehensive coverage

High-value items (>$500)

100%

Insurance readiness

Items with photos

80%+

Claims documentation

Items with receipts

70%+

Proof of purchase

Items with serial numbers

90%+ (where applicable)

Theft recovery