# BLUEPRINT: Stack Stock
# Version: 1.0.0
# URL: https://stackstock.app
# Updated: 2026-09-20

## CAPABILITY: add-catalog-item
description: Add a new item to the inventory catalog with name, SKU, type, and starting quantity.
input:
  - name: item-name
    type: string
    required: true
    description: Display name for the item
  - name: item-sku
    type: string
    required: true
    description: SKU or barcode identifier
  - name: item-type
    type: string
    required: true
    description: Item category or type label
  - name: quantity
    type: number
    required: true
    description: Starting quantity on hand
output:
  - type: confirmation
    retrieval: inline
    description: Item created and item detail page shown
auth-required: true
scope: form-submit

### UI
steps:
  1. ASSERT-AUTH
  2. NAVIGATE /items/new
  3. WAIT [data-agent-id="item-name-input"] (max: 10s)
  4. INPUT [data-agent-id="item-name-input"] <<item-name>>
  5. INPUT [data-agent-id="item-sku-input"] <<item-sku>>
  6. INPUT [data-agent-id="item-type-input"] <<item-type>>
  7. INPUT [data-agent-id="item-quantity-input"] <<quantity>>
  8. CLICK [data-agent-id="item-save-button"]
  9. WAIT [data-agent-id="item-detail-name"] (max: 10s)
  10. VERIFY selector_exists [data-agent-id="item-detail-name"]

## CAPABILITY: adjust-stock
description: Increase or decrease on-hand stock for an existing catalog item.
input:
  - name: item-id
    type: string
    required: true
    description: Catalog item identifier
  - name: direction
    type: string
    required: true
    description: Stock movement direction — in or out
  - name: amount
    type: number
    required: true
    description: Units to add or remove
  - name: reason
    type: string
    required: false
    description: Optional note for the stock movement
output:
  - type: confirmation
    retrieval: inline
    description: Stock adjusted and item detail page shown
auth-required: true
scope: form-submit

### UI
steps:
  1. ASSERT-AUTH
  2. NAVIGATE /items/<<item-id>>/adjust?type=<<direction>>
  3. WAIT [data-agent-id="stock-adjust-amount"] (max: 10s)
  4. INPUT [data-agent-id="stock-adjust-amount"] <<amount>>
  5. INPUT [data-agent-id="stock-adjust-reason"] <<reason>>
  6. CLICK [data-agent-id="stock-adjust-confirm"]
  7. WAIT [data-agent-id="item-detail-name"] (max: 10s)
  8. VERIFY selector_exists [data-agent-id="item-detail-name"]

## CAPABILITY: view-item-list
description: Open the authenticated item list showing catalog entries and on-hand quantities.
input: []
output:
  - type: confirmation
    retrieval: inline
    description: Item list page loaded
auth-required: true
scope: read-only

### UI
steps:
  1. ASSERT-AUTH
  2. NAVIGATE /items
  3. WAIT [data-agent-id="items-list"] (max: 10s)
  4. VERIFY selector_exists [data-agent-id="items-list"]

## IDENTITY
name: Stack Stock
description: Inventory tracking for supplies, resale, and manufacturing.
category: productivity
contact: stackapps.app@gmail.com

## SUMMARY
tagline: Inventory tracking for supplies, resale, and manufacturing.
capabilities:
  - add-catalog-item: Add a catalog item with name, SKU, type, and starting quantity
  - adjust-stock: Add or remove stock for an existing item
  - view-item-list: View the item list and on-hand quantities

## AUTH
provider: firebase
methods: email-password, oauth-google

## ACCESS
last-resort: ui