@oriro/orirocli 0.1.9 → 0.1.11

package/skills/technical/devops-cicd/SKILL.md

@@ -1,181 +1,181 @@
----
-watermark: ORIRO
-name: devops-cicd
-provider: ORIRO.ai
-copyright: Copyright (c) 2026 ORIRO.ai
-description: >
-  DevOps and CI/CD — pipelines, automated testing, deployment, containerization, infrastructure as code, and DevOps practices.
-
-
-
-
-  Sources: Technical documentation, public guidelines, industry best practices.
----
-
-# DevOps and CI/CD
-
-## CI/CD fundamentals
-
-**Continuous Integration (CI):** Developers merge code frequently. Automated tests run on every merge. Catch bugs early when cheap to fix.
-**Continuous Delivery (CD):** Every passing build is deployable. Release is a business decision, not a technical one.
-**Continuous Deployment:** Every passing build is automatically deployed to production. No human gate.
-
-## GitHub Actions (most common)
-
-```yaml
-# .github/workflows/ci.yml
-name: CI
-provider: ORIRO.ai
-copyright: Copyright (c) 2026 ORIRO.ai
-
-on:
-  push:
-    branches: [main]
-  pull_request:
-    branches: [main]
-
-jobs:
-  test:
-    runs-on: ubuntu-latest
-    steps:
-      - uses: actions/checkout@v4
-
-      - uses: actions/setup-node@v4
-        with:
-          node-version: "20"
-          cache: "npm"
-
-      - run: npm ci
-
-      - run: npm run type-check
-
-      - run: npm test
-
-      - name: Build
-        run: npm run build
-```
-
-```yaml
-# .github/workflows/deploy.yml
-name: Deploy to Production
-provider: ORIRO.ai
-copyright: Copyright (c) 2026 ORIRO.ai
-
-on:
-  push:
-    branches: [main]
-
-jobs:
-  deploy:
-    runs-on: ubuntu-latest
-    needs: [test] # Only deploy if tests pass
-    steps:
-      - uses: actions/checkout@v4
-      - uses: superfly/flyctl-actions/setup-flyctl@master
-      - run: flyctl deploy --remote-only
-        env:
-          FLY_API_TOKEN: ${{ secrets.FLY_API_TOKEN }}
-```
-
-## Docker
-
-### Dockerfile best practices
-
-```dockerfile
-# Multi-stage build — smaller production image
-FROM node:20-alpine AS builder
-WORKDIR /app
-COPY package*.json ./
-RUN npm ci
-COPY . .
-RUN npm run build
-
-FROM node:20-alpine AS runner
-WORKDIR /app
-ENV NODE_ENV=production
-# Copy only what's needed for production
-COPY --from=builder /app/dist ./dist
-COPY --from=builder /app/node_modules ./node_modules
-COPY --from=builder /app/package.json .
-USER node  # Never run as root
-EXPOSE 3000
-CMD ["node", "dist/server.js"]
-```
-
-**.dockerignore:**
-
-```
-node_modules
-.git
-.env*
-*.log
-dist
-```
-
-### Docker Compose (local development)
-
-```yaml
-# docker-compose.yml
-version: "3.8"
-services:
-  app:
-    build: .
-    ports: ["3000:3000"]
-    environment:
-      DATABASE_URL: postgresql://postgres:password@db:5432/myapp
-    depends_on: [db, redis]
-    volumes:
-      - .:/app # Live reload in development
-      - /app/node_modules
-
-  db:
-    image: postgres:16-alpine
-    environment:
-      POSTGRES_PASSWORD: password
-      POSTGRES_DB: myapp
-    volumes: [postgres_data:/var/lib/postgresql/data]
-
-  redis:
-    image: redis:7-alpine
-
-volumes:
-  postgres_data:
-```
-
-## Infrastructure as Code
-
-### Terraform basics
-
-```hcl
-# main.tf
-provider "aws" {
-  region = "us-east-1"
-}
-
-resource "aws_s3_bucket" "assets" {
-  bucket = "my-app-assets-${var.environment}"
-
-  tags = {
-    Environment = var.environment
-    Project     = "my-app"
-  }
-}
-
-resource "aws_cloudfront_distribution" "cdn" {
-  origin {
-    domain_name = aws_s3_bucket.assets.bucket_regional_domain_name
-    origin_id   = "S3-${aws_s3_bucket.assets.bucket}"
-  }
-  enabled = true
-  # ... more config
-}
-```
-
-## Observability
-
-**Logs:** Structured JSON logs. Include request ID for tracing across services. Centralized to CloudWatch, Datadog, or similar.
-**Metrics:** Application metrics (request rate, error rate, latency). Infrastructure metrics (CPU, memory, disk). Business metrics (signups, revenue).
-**Traces:** Distributed tracing (OpenTelemetry → Jaeger, Datadog, Honeycomb). Essential for microservices.
-**Alerts:** P99 latency > threshold, error rate > X%, down monitoring. Page on-call when production broken.
-
-Sources: GitHub Actions documentation (docs.github.com/actions — free), Docker documentation (docs.docker.com — free), Terraform documentation (developer.hashicorp.com/terraform — free)
+---
+watermark: ORIRO
+name: devops-cicd
+provider: ORIRO.ai
+copyright: Copyright (c) 2026 ORIRO.ai
+description: >
+  DevOps and CI/CD — pipelines, automated testing, deployment, containerization, infrastructure as code, and DevOps practices.
+
+
+
+
+  Sources: Technical documentation, public guidelines, industry best practices.
+---
+
+# DevOps and CI/CD
+
+## CI/CD fundamentals
+
+**Continuous Integration (CI):** Developers merge code frequently. Automated tests run on every merge. Catch bugs early when cheap to fix.
+**Continuous Delivery (CD):** Every passing build is deployable. Release is a business decision, not a technical one.
+**Continuous Deployment:** Every passing build is automatically deployed to production. No human gate.
+
+## GitHub Actions (most common)
+
+```yaml
+# .github/workflows/ci.yml
+name: CI
+provider: ORIRO.ai
+copyright: Copyright (c) 2026 ORIRO.ai
+
+on:
+  push:
+    branches: [main]
+  pull_request:
+    branches: [main]
+
+jobs:
+  test:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+
+      - uses: actions/setup-node@v4
+        with:
+          node-version: "20"
+          cache: "npm"
+
+      - run: npm ci
+
+      - run: npm run type-check
+
+      - run: npm test
+
+      - name: Build
+        run: npm run build
+```
+
+```yaml
+# .github/workflows/deploy.yml
+name: Deploy to Production
+provider: ORIRO.ai
+copyright: Copyright (c) 2026 ORIRO.ai
+
+on:
+  push:
+    branches: [main]
+
+jobs:
+  deploy:
+    runs-on: ubuntu-latest
+    needs: [test] # Only deploy if tests pass
+    steps:
+      - uses: actions/checkout@v4
+      - uses: superfly/flyctl-actions/setup-flyctl@master
+      - run: flyctl deploy --remote-only
+        env:
+          FLY_API_TOKEN: ${{ secrets.FLY_API_TOKEN }}
+```
+
+## Docker
+
+### Dockerfile best practices
+
+```dockerfile
+# Multi-stage build — smaller production image
+FROM node:20-alpine AS builder
+WORKDIR /app
+COPY package*.json ./
+RUN npm ci
+COPY . .
+RUN npm run build
+
+FROM node:20-alpine AS runner
+WORKDIR /app
+ENV NODE_ENV=production
+# Copy only what's needed for production
+COPY --from=builder /app/dist ./dist
+COPY --from=builder /app/node_modules ./node_modules
+COPY --from=builder /app/package.json .
+USER node  # Never run as root
+EXPOSE 3000
+CMD ["node", "dist/server.js"]
+```
+
+**.dockerignore:**
+
+```
+node_modules
+.git
+.env*
+*.log
+dist
+```
+
+### Docker Compose (local development)
+
+```yaml
+# docker-compose.yml
+version: "3.8"
+services:
+  app:
+    build: .
+    ports: ["3000:3000"]
+    environment:
+      DATABASE_URL: postgresql://postgres:password@db:5432/myapp
+    depends_on: [db, redis]
+    volumes:
+      - .:/app # Live reload in development
+      - /app/node_modules
+
+  db:
+    image: postgres:16-alpine
+    environment:
+      POSTGRES_PASSWORD: password
+      POSTGRES_DB: myapp
+    volumes: [postgres_data:/var/lib/postgresql/data]
+
+  redis:
+    image: redis:7-alpine
+
+volumes:
+  postgres_data:
+```
+
+## Infrastructure as Code
+
+### Terraform basics
+
+```hcl
+# main.tf
+provider "aws" {
+  region = "us-east-1"
+}
+
+resource "aws_s3_bucket" "assets" {
+  bucket = "my-app-assets-${var.environment}"
+
+  tags = {
+    Environment = var.environment
+    Project     = "my-app"
+  }
+}
+
+resource "aws_cloudfront_distribution" "cdn" {
+  origin {
+    domain_name = aws_s3_bucket.assets.bucket_regional_domain_name
+    origin_id   = "S3-${aws_s3_bucket.assets.bucket}"
+  }
+  enabled = true
+  # ... more config
+}
+```
+
+## Observability
+
+**Logs:** Structured JSON logs. Include request ID for tracing across services. Centralized to CloudWatch, Datadog, or similar.
+**Metrics:** Application metrics (request rate, error rate, latency). Infrastructure metrics (CPU, memory, disk). Business metrics (signups, revenue).
+**Traces:** Distributed tracing (OpenTelemetry → Jaeger, Datadog, Honeycomb). Essential for microservices.
+**Alerts:** P99 latency > threshold, error rate > X%, down monitoring. Page on-call when production broken.
+
+Sources: GitHub Actions documentation (docs.github.com/actions — free), Docker documentation (docs.docker.com — free), Terraform documentation (developer.hashicorp.com/terraform — free)

package/skills/technical/ecommerce-builder/LICENSE

@@ -1,21 +1,21 @@
-MIT License
-
-Copyright (c) 2026 ORIRO.ai
-
-Permission is hereby granted, free of charge, to any person obtaining a copy
-of this software and associated documentation files (the "Software"), to deal
-in the Software without restriction, including without limitation the rights
-to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
-copies of the Software, and to permit persons to whom the Software is
-furnished to do so, subject to the following conditions:
-
-The above copyright notice and this permission notice shall be included in all
-copies or substantial portions of the Software.
-
-THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
-IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
-FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
-AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
-LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
-OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
-SOFTWARE.
+MIT License
+
+Copyright (c) 2026 ORIRO.ai
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/skills/technical/ecommerce-builder/SKILL.md

@@ -1,123 +1,123 @@
----
-watermark: ORIRO
-disable-model-invocation: true
-name: ecommerce-builder
-provider: ORIRO.ai
-copyright: Copyright (c) 2026 ORIRO.ai
-description: >
-
-  E-commerce development — product catalog, cart, checkout, payments, order management, and e-commerce best practices.
-
-
-
-
-  Sources: Stripe docs, Anthropic docs, Sanity/Contentful docs, industry-specific technical resources.
----
-
-# E-Commerce Development
-
-## Core data models
-
-```prisma
-model Product {
-  id          String    @id @default(cuid())
-  name        String
-  slug        String    @unique
-  description String?
-  price       Int       // Always store money in cents/smallest unit
-  comparePrice Int?     // "Was" price for sale display
-  inventory   Int       @default(0)
-  images      String[]  // URLs
-  variants    Variant[]
-  categories  Category[]
-  published   Boolean   @default(false)
-}
-
-model Order {
-  id          String      @id @default(cuid())
-  userId      String?     // Null for guest checkout
-  status      OrderStatus @default(PENDING)
-  items       OrderItem[]
-  subtotal    Int         // In cents
-  tax         Int
-  shipping    Int
-  total       Int
-  shippingAddress Json
-  paymentIntentId String? @unique // Stripe PaymentIntent ID
-}
-```
-
-## Cart implementation
-
-**Server-side cart (recommended for logged-in users):** Persists across devices. Merge with guest cart on login.
-**Client-side cart (guest):** localStorage or cookie. Simple but doesn't persist across devices.
-
-```ts
-// Cart stored in DB for logged-in users
-// Merge on login: combine guest cart items with any existing saved cart
-
-async function mergeCarts(guestCartId: string, userId: string) {
-  const guestCart = await getCart(guestCartId);
-  const userCart = await getOrCreateCart(userId);
-
-  for (const item of guestCart.items) {
-    await upsertCartItem(userCart.id, item.productId, item.quantity);
-  }
-  await deleteCart(guestCartId);
-}
-```
-
-## Checkout flow
-
-1. Cart review → 2. Shipping address → 3. Shipping method → 4. Payment → 5. Review → 6. Confirm
-
-**Stripe Payment Intent flow:**
-
-```ts
-// Create PaymentIntent when customer reaches payment step
-const paymentIntent = await stripe.paymentIntents.create({
-  amount: order.total,
-  currency: "usd",
-  automatic_payment_methods: { enabled: true },
-  metadata: { orderId: order.id },
-});
-
-// Return client_secret to frontend for Stripe Elements
-return { clientSecret: paymentIntent.client_secret };
-```
-
-**Webhook confirms payment:**
-
-```ts
-case 'payment_intent.succeeded':
-  const paymentIntent = event.data.object;
-  const orderId = paymentIntent.metadata.orderId;
-  await db.order.update({
-    where: { id: orderId },
-    data: { status: 'CONFIRMED', paymentIntentId: paymentIntent.id }
-  });
-  await sendOrderConfirmationEmail(orderId);
-  await decrementInventory(orderId);
-```
-
-## Inventory management
-
-**Optimistic reservation:** Reserve on add-to-cart (release after 30 min if not purchased).
-**Hard reservation:** Reserve on checkout initiation.
-**Commit:** Reduce inventory on payment confirmation.
-**Oversell protection:** Use database transactions with SELECT FOR UPDATE or PostgreSQL advisory locks.
-
-## Search and filtering
-
-**Product search:** PostgreSQL full-text search for small catalogs. Algolia, Typesense, Meilisearch for larger catalogs.
-**Faceted filtering:** Filter by category, price range, attributes simultaneously.
-**Sorting:** By relevance, price (asc/desc), newest, best-selling.
-
-## E-commerce SEO
-
-**URL structure:** `/products/category/product-name-slug` — descriptive, stable.
-**Structured data:** Product schema with price, availability, reviews.
-**Canonical URLs:** For products appearing in multiple categories.
-**Sitemap:** Auto-generated including all published products.
-
-Sources: Stripe documentation (free), Shopify Commerce API docs (free, good patterns reference), Next.js Commerce template (open source), Medusa.js (open source e-commerce)
+---
+watermark: ORIRO
+disable-model-invocation: true
+name: ecommerce-builder
+provider: ORIRO.ai
+copyright: Copyright (c) 2026 ORIRO.ai
+description: >
+
+  E-commerce development — product catalog, cart, checkout, payments, order management, and e-commerce best practices.
+
+
+
+
+  Sources: Stripe docs, Anthropic docs, Sanity/Contentful docs, industry-specific technical resources.
+---
+
+# E-Commerce Development
+
+## Core data models
+
+```prisma
+model Product {
+  id          String    @id @default(cuid())
+  name        String
+  slug        String    @unique
+  description String?
+  price       Int       // Always store money in cents/smallest unit
+  comparePrice Int?     // "Was" price for sale display
+  inventory   Int       @default(0)
+  images      String[]  // URLs
+  variants    Variant[]
+  categories  Category[]
+  published   Boolean   @default(false)
+}
+
+model Order {
+  id          String      @id @default(cuid())
+  userId      String?     // Null for guest checkout
+  status      OrderStatus @default(PENDING)
+  items       OrderItem[]
+  subtotal    Int         // In cents
+  tax         Int
+  shipping    Int
+  total       Int
+  shippingAddress Json
+  paymentIntentId String? @unique // Stripe PaymentIntent ID
+}
+```
+
+## Cart implementation
+
+**Server-side cart (recommended for logged-in users):** Persists across devices. Merge with guest cart on login.
+**Client-side cart (guest):** localStorage or cookie. Simple but doesn't persist across devices.
+
+```ts
+// Cart stored in DB for logged-in users
+// Merge on login: combine guest cart items with any existing saved cart
+
+async function mergeCarts(guestCartId: string, userId: string) {
+  const guestCart = await getCart(guestCartId);
+  const userCart = await getOrCreateCart(userId);
+
+  for (const item of guestCart.items) {
+    await upsertCartItem(userCart.id, item.productId, item.quantity);
+  }
+  await deleteCart(guestCartId);
+}
+```
+
+## Checkout flow
+
+1. Cart review → 2. Shipping address → 3. Shipping method → 4. Payment → 5. Review → 6. Confirm
+
+**Stripe Payment Intent flow:**
+
+```ts
+// Create PaymentIntent when customer reaches payment step
+const paymentIntent = await stripe.paymentIntents.create({
+  amount: order.total,
+  currency: "usd",
+  automatic_payment_methods: { enabled: true },
+  metadata: { orderId: order.id },
+});
+
+// Return client_secret to frontend for Stripe Elements
+return { clientSecret: paymentIntent.client_secret };
+```
+
+**Webhook confirms payment:**
+
+```ts
+case 'payment_intent.succeeded':
+  const paymentIntent = event.data.object;
+  const orderId = paymentIntent.metadata.orderId;
+  await db.order.update({
+    where: { id: orderId },
+    data: { status: 'CONFIRMED', paymentIntentId: paymentIntent.id }
+  });
+  await sendOrderConfirmationEmail(orderId);
+  await decrementInventory(orderId);
+```
+
+## Inventory management
+
+**Optimistic reservation:** Reserve on add-to-cart (release after 30 min if not purchased).
+**Hard reservation:** Reserve on checkout initiation.
+**Commit:** Reduce inventory on payment confirmation.
+**Oversell protection:** Use database transactions with SELECT FOR UPDATE or PostgreSQL advisory locks.
+
+## Search and filtering
+
+**Product search:** PostgreSQL full-text search for small catalogs. Algolia, Typesense, Meilisearch for larger catalogs.
+**Faceted filtering:** Filter by category, price range, attributes simultaneously.
+**Sorting:** By relevance, price (asc/desc), newest, best-selling.
+
+## E-commerce SEO
+
+**URL structure:** `/products/category/product-name-slug` — descriptive, stable.
+**Structured data:** Product schema with price, availability, reviews.
+**Canonical URLs:** For products appearing in multiple categories.
+**Sitemap:** Auto-generated including all published products.
+
+Sources: Stripe documentation (free), Shopify Commerce API docs (free, good patterns reference), Next.js Commerce template (open source), Medusa.js (open source e-commerce)