@oriro/orirocli 0.1.0

package/skills/craft/zero-to-live/SKILL.md

@@ -0,0 +1,422 @@
+---
+watermark: ORIRO
+name: zero-to-live
+provider: ORIRO.ai
+copyright: Copyright (c) 2026 ORIRO.ai
+description: >
+  Deploy any app to production for $0 using the ORIRO canonical free stack.
+  Activate for ANY task involving deployment, hosting, going live, publishing,
+  "how do I put this online", "make it accessible", "share the URL", "deploy",
+  "host my app", "launch", "publish", or any question about infrastructure,
+  cloud platforms, databases, or making something work on the internet.
+  Also activate for: Vercel, Supabase, Cloudflare, Resend, Stripe setup,
+  domain configuration, SSL, environment variables, or free tier questions.
+  This skill contains exact commands — no assumed knowledge required.
+  Always use this skill before recommending any paid hosting option.
+---
+
+# Skill A — Zero to Live
+
+## Free deployment stack. Exact commands. No assumed knowledge.
+
+**The ORIRO canonical free stack — total cost $0 at launch:**
+
+| Layer                 | Service            | Free tier                    |
+| --------------------- | ------------------ | ---------------------------- |
+| Frontend / Full-stack | Vercel             | 100GB bandwidth/month        |
+| Database + Auth       | Supabase           | 500MB, 50K users             |
+| API / Serverless      | Cloudflare Workers | 100K requests/day            |
+| Static sites          | Cloudflare Pages   | Unlimited bandwidth          |
+| File storage          | Cloudflare R2      | 10GB, 10M reads/month        |
+| Email                 | Resend             | 3,000 emails/month           |
+| Domain + SSL          | Cloudflare         | Free, automatic              |
+| Payments              | Stripe             | Free until first transaction |
+
+---
+
+## STEP 0 — Which platform for which app
+
+```
+What are you building?
+│
+├─ Full-stack web app (Next.js / React + backend)
+│   └─ Vercel + Supabase
+│
+├─ Static site (HTML/CSS only, no server)
+│   └─ Cloudflare Pages
+│
+├─ API only (no frontend)
+│   └─ Cloudflare Workers
+│
+├─ Mobile app (React Native / Expo)
+│   └─ Expo EAS (build) + Vercel (API) + Supabase (database)
+│
+├─ E-commerce
+│   └─ Vercel + Supabase + Stripe Checkout
+│
+└─ Anything with user accounts
+    └─ Vercel + Supabase Auth
+```
+
+---
+
+## VERCEL — deploy in 3 commands
+
+```bash
+# 1. Install CLI
+npm install -g vercel
+
+# 2. Deploy (from project root)
+vercel
+
+# 3. Deploy to production
+vercel --prod
+```
+
+**First deploy prompts:**
+
+```
+Set up and deploy? → Y
+Which scope? → your-username
+Link to existing project? → N
+Project name? → your-app-name
+Directory? → ./ (or apps/web for monorepo)
+Override settings? → N
+```
+
+Your app is live at: `https://your-app-name.vercel.app`
+
+**Connect GitHub (auto-deploy on every push):**
+vercel.com → Import Project → Connect GitHub repo
+Every push to main → automatic production deploy (~60 seconds)
+
+**Environment variables:**
+
+```bash
+vercel env add SECRET_KEY production
+vercel env add SECRET_KEY preview
+vercel env pull .env.local        # pull to local
+```
+
+Never put secrets in code. Always in Vercel dashboard or CLI.
+
+**Custom domain:**
+vercel.com → Project → Settings → Domains → Add domain
+For Cloudflare DNS: set CNAME to `cname.vercel-dns.com`, proxy OFF.
+
+**vercel.json (monorepo only):**
+
+```json
+{ "rootDirectory": "apps/web" }
+```
+
+**Common Vercel errors:**
+
+- `Cannot find module` → run `npm install` locally, commit lock file
+- `Function exceeded maximum duration` → move heavy work to background
+- `413 Request Entity Too Large` → use direct-to-R2 upload instead
+- `Environment variable undefined` → variable set for Dev not Production
+
+---
+
+## SUPABASE — database + auth in 5 minutes
+
+**Setup:**
+
+1. supabase.com → New project → name, password, region
+2. Wait ~2 min → Settings → API → copy:
+   - Project URL → `NEXT_PUBLIC_SUPABASE_URL`
+   - anon public → `NEXT_PUBLIC_SUPABASE_ANON_KEY`
+   - service_role → `SUPABASE_SERVICE_ROLE_KEY` (server only)
+
+```bash
+npm install @supabase/supabase-js @supabase/ssr
+```
+
+**Client (browser):**
+
+```typescript
+// lib/supabase/client.ts
+import { createBrowserClient } from "@supabase/ssr";
+export const supabase = createBrowserClient(
+  process.env.NEXT_PUBLIC_SUPABASE_URL!,
+  process.env.NEXT_PUBLIC_SUPABASE_ANON_KEY!,
+);
+```
+
+**Server (API routes / Server Components):**
+
+```typescript
+// lib/supabase/server.ts
+import { createServerClient } from "@supabase/ssr";
+import { cookies } from "next/headers";
+export function createClient() {
+  return createServerClient(
+    process.env.NEXT_PUBLIC_SUPABASE_URL!,
+    process.env.NEXT_PUBLIC_SUPABASE_ANON_KEY!,
+    {
+      cookies: {
+        getAll: () => cookies().getAll(),
+        setAll: (c) => c.forEach(({ name, value, options }) => cookies().set(name, value, options)),
+      },
+    },
+  );
+}
+```
+
+**Create a table (SQL editor in Supabase dashboard):**
+
+```sql
+CREATE TABLE products (
+  id UUID DEFAULT gen_random_uuid() PRIMARY KEY,
+  name TEXT NOT NULL,
+  price INTEGER NOT NULL,      -- store cents, never floats for money
+  user_id UUID REFERENCES auth.users(id) ON DELETE CASCADE,
+  created_at TIMESTAMPTZ DEFAULT NOW()
+);
+ALTER TABLE products ENABLE ROW LEVEL SECURITY;
+CREATE POLICY "Users see own products"
+  ON products FOR SELECT USING (auth.uid() = user_id);
+CREATE POLICY "Users insert own products"
+  ON products FOR INSERT WITH CHECK (auth.uid() = user_id);
+```
+
+**Query:**
+
+```typescript
+const { data, error } = await supabase
+  .from("products")
+  .select("*")
+  .order("created_at", { ascending: false });
+```
+
+**Insert:**
+
+```typescript
+const { data, error } = await supabase
+  .from("products")
+  .insert({ name: "T-Shirt", price: 2999, user_id: user.id })
+  .select()
+  .single();
+```
+
+**Auth — email magic link:**
+
+```typescript
+await supabase.auth.signInWithOtp({
+  email: "<email>",
+  options: { emailRedirectTo: "https://yourapp.com/auth/callback" },
+});
+```
+
+**Auth callback route:**
+
+```typescript
+// app/auth/callback/route.ts
+import { createClient } from "@/lib/supabase/server";
+import { NextResponse } from "next/server";
+export async function GET(request: Request) {
+  const code = new URL(request.url).searchParams.get("code");
+  if (code) await createClient().auth.exchangeCodeForSession(code);
+  return NextResponse.redirect(new URL("/app", request.url));
+}
+```
+
+**Get current user (server component):**
+
+```typescript
+const {
+  data: { user },
+} = await createClient().auth.getUser();
+if (!user) redirect("/login");
+```
+
+**Supabase errors:**
+
+- `relation does not exist` → table not created, check SQL editor
+- `violates row-level security` → RLS policy missing for that operation
+- `JWT expired` → call `supabase.auth.refreshSession()` or redirect to login
+- `unique constraint violation` → duplicate in UNIQUE column, use upsert
+
+---
+
+## CLOUDFLARE WORKERS — serverless API
+
+```bash
+npm install -g wrangler
+wrangler login
+wrangler init my-api
+cd my-api
+wrangler deploy
+```
+
+**Basic worker:**
+
+```typescript
+// src/index.ts
+export default {
+  async fetch(request: Request): Promise<Response> {
+    const url = new URL(request.url);
+
+    if (url.pathname === "/api/hello") {
+      return Response.json({ message: "Hello from ORIRO" });
+    }
+
+    return new Response("Not found", { status: 404 });
+  },
+};
+```
+
+**With CORS (required for browser requests):**
+
+```typescript
+const corsHeaders = {
+  "Access-Control-Allow-Origin": "*",
+  "Access-Control-Allow-Methods": "GET,POST,PUT,DELETE,OPTIONS",
+  "Access-Control-Allow-Headers": "Content-Type,Authorization",
+};
+if (request.method === "OPTIONS") return new Response(null, { headers: corsHeaders });
+return Response.json(data, { headers: corsHeaders });
+```
+
+**wrangler.toml:**
+
+```toml
+name = "my-api"
+main = "src/index.ts"
+compatibility_date = "2024-01-01"
+
+[vars]
+ENVIRONMENT = "production"
+
+[[d1_databases]]
+binding = "DB"
+database_name = "my-database"
+database_id = "xxxx"
+```
+
+**Secrets:**
+
+```bash
+wrangler secret put API_KEY
+wrangler secret put DATABASE_URL
+```
+
+---
+
+## CLOUDFLARE PAGES — static sites
+
+```bash
+# From project folder
+wrangler pages deploy ./dist --project-name my-site
+```
+
+Or connect GitHub: pages.cloudflare.com → Create project → Connect Git
+Build command: `npm run build`
+Build output: `dist` or `out` or `.next`
+
+---
+
+## RESEND — transactional email
+
+```bash
+npm install resend
+```
+
+```typescript
+import { Resend } from "resend";
+const resend = new Resend(process.env.RESEND_API_KEY);
+
+await resend.emails.send({
+  from: "ORIRO <<email>>",
+  to: ["<email>"],
+  subject: "Welcome to the platform",
+  html: '<p>You are in. <a href="...">Get started →</a></p>',
+});
+```
+
+**Domain setup:** resend.com → Domains → Add domain → add DNS records in Cloudflare
+
+---
+
+## STRIPE — payments
+
+```bash
+npm install stripe @stripe/stripe-js
+```
+
+**One-time payment (Stripe Checkout):**
+
+```typescript
+// app/api/checkout/route.ts
+import Stripe from "stripe";
+const stripe = new Stripe(process.env.STRIPE_SECRET_KEY!);
+
+export async function POST(request: Request) {
+  const session = await stripe.checkout.sessions.create({
+    payment_method_types: ["card"],
+    line_items: [
+      {
+        price_data: {
+          currency: "usd",
+          product_data: { name: "Your Product" },
+          unit_amount: 2999, // $29.99 in cents
+        },
+        quantity: 1,
+      },
+    ],
+    mode: "payment",
+    success_url: "https://yourapp.com/success",
+    cancel_url: "https://yourapp.com/cancel",
+  });
+  return Response.json({ url: session.url });
+}
+```
+
+**Webhook (confirm payment on your server):**
+
+```typescript
+// app/api/webhook/route.ts
+export async function POST(request: Request) {
+  const body = await request.text();
+  const sig = request.headers.get("stripe-signature")!;
+  const event = stripe.webhooks.constructEvent(body, sig, process.env.STRIPE_WEBHOOK_SECRET!);
+  if (event.type === "checkout.session.completed") {
+    // payment confirmed — fulfill the order
+    const session = event.data.object;
+    await fulfillOrder(session);
+  }
+  return Response.json({ received: true });
+}
+```
+
+**Keys:** stripe.com → Developers → API keys
+
+- `STRIPE_SECRET_KEY` — server only, never expose
+- `NEXT_PUBLIC_STRIPE_PUBLISHABLE_KEY` — safe for client
+
+---
+
+## Environment variables — the complete pattern
+
+**.env.local (never commit — add to .gitignore):**
+
+```
+NEXT_PUBLIC_SUPABASE_URL=https://xxxx.supabase.co
+NEXT_PUBLIC_SUPABASE_ANON_KEY=eyJh...
+SUPABASE_SERVICE_ROLE_KEY=eyJh...
+STRIPE_SECRET_KEY=sk_test_...
+STRIPE_WEBHOOK_SECRET=whsec_...
+NEXT_PUBLIC_STRIPE_PUBLISHABLE_KEY=pk_test_...
+RESEND_API_KEY=re_...
+```
+
+**.gitignore must include:**
+
+```
+.env
+.env.local
+.env*.local
+```
+
+Set the same variables in Vercel dashboard for production.

package/skills/creative/creative-3d-modeling/LICENSE

@@ -0,0 +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.

package/skills/creative/creative-3d-modeling/SKILL.md

@@ -0,0 +1,70 @@
+---
+watermark: ORIRO
+disable-model-invocation: true
+name: creative-3d-modeling
+provider: ORIRO.ai
+copyright: Copyright (c) 2026 ORIRO.ai
+description: >
+  3D modeling — Blender, FreeCAD, OpenSCAD, mesh modeling, and 3D printing
+  preparation. Activate for 3D design, modeling questions, or print preparation.
+  Sources: Blender Foundation (CC-BY), FreeCAD docs (LGPL), Prusa Knowledge Base.
+---
+
+# 3D Modeling and Design
+
+## Blender (free, open source — blender.org)
+
+### Interface basics
+
+**Number pad:** 1=front, 3=side, 7=top, 5=ortho/perspective toggle, 0=camera.
+**G/R/S:** Grab, Rotate, Scale. Follow with X/Y/Z to constrain.
+G X 2 = move 2 units along X. R Z 45 = rotate 45° around Z.
+**Tab:** Toggle Object Mode / Edit Mode.
+
+### Modeling in Edit Mode
+
+**Extrude (E):** Pull geometry out.
+**Loop Cut (Ctrl+R):** Add edge loops. Scroll wheel for more loops.
+**Bevel (Ctrl+B):** Round edges.
+**Boolean Modifier:** Union, Difference, Intersect operations.
+**Subdivision Surface:** Adds smooth subdivisions non-destructively. Level 2-3 for most objects.
+
+## FreeCAD (parametric CAD, free)
+
+For engineering/technical design. Dimensions drive geometry.
+**Workflow:** New Sketch → Draw 2D profile → Constrain fully (blue = fully constrained) → Pad (extrude) or Pocket (cut).
+**Constraints:** Horizontal, Vertical, Coincident, Distance, Angle, Equal.
+
+## OpenSCAD (code-based 3D modeling, free)
+
+Describe 3D objects with code. Great for parametric designs.
+
+```openscad
+difference() {
+    cylinder(h=80, r=40, $fn=100);
+    translate([0, 0, 5])
+        cylinder(h=80, r=37, $fn=100);
+}
+```
+
+**Primitives:** cube(), sphere(), cylinder().
+**Boolean:** union(), difference(), intersection().
+
+## 3D Printing Preparation
+
+**Slicer software:** PrusaSlicer (free), Cura (free), OrcaSlicer (free).
+**Key settings:**
+Layer height: 0.2mm standard. 0.1mm fine detail. 0.3mm fast.
+Infill: 15-20% general. 40-60% structural.
+Walls: 3-4 for structural parts.
+Supports: Required for overhangs >45°.
+**Filament temperatures:** PLA 200-220°C. PETG 230-250°C. ABS 240-260°C.
+
+## Mesh optimization
+
+**Manifold mesh:** Closed surface, no holes. Required for printing.
+**Wall thickness:** Minimum 1.2mm (3 extrusion widths at 0.4mm nozzle).
+**Tolerances:** 0.2-0.4mm for mechanical fits.
+
+Sources: Blender Foundation tutorials (blender.org, CC-BY), FreeCAD docs (LGPL),
+OpenSCAD manual (free), Prusa Knowledge Base (free)

package/skills/creative/creative-architecture/LICENSE

@@ -0,0 +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.

package/skills/creative/creative-architecture/SKILL.md

@@ -0,0 +1,94 @@
+---
+watermark: ORIRO
+disable-model-invocation: true
+name: creative-architecture
+provider: ORIRO.ai
+copyright: Copyright (c) 2026 ORIRO.ai
+description: >
+
+
+
+
+
+
+  Architecture basics — spatial design, structural systems, building codes, sustainability, and architectural history.
+  Sources: Open educational resources, Canva Design School, MIT OCW Architecture, design classics.
+---
+
+# Architecture Basics
+
+## Principles of architectural design
+
+### The Vitruvian triad (30 BC — still foundational)
+
+**Firmitas:** Structural integrity and durability.
+**Utilitas:** Functionality and practicality.
+**Venustas:** Beauty and aesthetic pleasure.
+Good architecture serves all three simultaneously.
+
+### Space, form, and light
+
+**Space:** Architecture creates space, not objects. The volume enclosed defines the experience.
+Compression and release: Moving from low ceiling to high ceiling creates emotional impact.
+Prospect and refuge: Humans prefer spaces with both overview (prospect) and shelter (refuge).
+
+**Form:** Relationship of the building to context, program, structure.
+Form follows function (Sullivan): Practical function should determine form.
+Form and function are one (Wright): More integrated view — function includes spiritual and aesthetic experience.
+
+**Light:** The most important material in architecture (Le Corbusier: "Architecture is the masterly, correct and magnificent play of masses brought together in light.")
+Natural light changes throughout the day and year — design considers this.
+North light (in northern hemisphere): Consistent, cool, diffuse. Studio light.
+South light: Warm, direct. Passive solar.
+
+## Structural systems
+
+**Load-bearing masonry:** Walls carry loads. No wall removal without replacement structure.
+**Post-and-beam:** Columns carry loads; walls non-structural. More flexible plans.
+**Steel frame:** Enables large spans, slender profiles, glass curtain walls.
+**Concrete frame (cast in place or precast):** Durable, fireproof, acoustically effective.
+**Long-span structures:** Trusses, space frames, arches, shells, tensile/cable structures.
+
+## Program and function
+
+Architectural program: List of spaces and requirements.
+Adjacency diagram: Which spaces need to be near each other?
+Circulation: How do people move through the building? Corridors, stairs, elevators.
+CORE: Central service area (elevators, stairs, mechanical, toilets) in tall buildings.
+
+## Building codes and zoning
+
+**Zoning:** Land use regulations.
+Setbacks: Minimum distance from property lines.
+FAR (Floor Area Ratio): Allowed total floor area / Site area. Determines building density.
+Use: Residential, commercial, industrial, mixed-use designations.
+
+**Building codes:**
+IBC (International Building Code): Adopted by most US jurisdictions with amendments.
+**Occupancy type** determines: Fire resistance rating, egress requirements, occupant load.
+**Egress:** Exit width, maximum travel distance to exits, number of exits required.
+For 1,000+ square feet, 2 independent exits typically required.
+**Fire separation:** Walls and floors rated for fire resistance separate occupancies.
+
+## Sustainable design
+
+**Passive design (most important):**
+Orientation: Long axis east-west captures winter sun.
+Shading: Overhangs sized to block summer sun, allow winter sun.
+Natural ventilation: Cross ventilation, stack effect.
+Insulation and thermal mass.
+
+**LEED certification:** Points-based system across: Sustainable sites, water, energy, materials, indoor quality.
+**Passive House standard:** Rigorous energy standard. Heat demand < 15 kWh/m²/year. Air leakage < 0.6 ACH at 50Pa.
+
+## Architectural history capsule
+
+Ancient: Post-and-lintel (Greece), arch and vault (Rome).
+Medieval: Gothic cathedral — flying buttresses liberate wall for glass.
+Renaissance: Classical revival, human scale and proportion.
+Industrial revolution: Iron and glass, new structural possibilities.
+Modernism (20th c.): Form follows function, rejection of ornament (Loos), white walls, flat roofs (Le Corbusier), open plan (Mies, Wright).
+Postmodernism: Ironic historical reference, complexity.
+Contemporary: Parametric design, sustainability, urban resilience.
+
+Sources: MIT OCW Architecture (free), Ching "Architecture: Form, Space, and Order" (principles), Frampton "Modern Architecture: A Critical History" (principles), IBC code provisions, Architecture 2030 (free climate resources)

package/skills/creative/creative-design-principles/LICENSE

@@ -0,0 +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.