docs: add Codra Code v0.2.3 release assets

Author: Abdulmuiz44

apps/code/demo/create-v0.2.3-video.sh

@@ -0,0 +1,108 @@
+#!/bin/bash
+set -euo pipefail
+
+# Codra Code v0.2.3 Demo Video Generator
+# Creates a terminal-style demo with Talocode branding
+
+ROOT="$(cd "$(dirname "$0")/.." && pwd)"
+OUTPUT="${ROOT}/docs/release/codra-code-v0.2.3-demo.mp4"
+TEMP_DIR="${ROOT}/demo/temp-v0.2.3"
+
+mkdir -p "$TEMP_DIR"
+
+# Talocode color scheme
+BG="0x1C1C1C"
+PRIMARY="0x58C4DD"
+SECONDARY="0x83C167"
+ACCENT="0xFFFF00"
+TEXT="0xFFFFFF"
+DIM="0x888888"
+GREEN="0x3FB950"
+BLUE="0x58A6FF"
+
+FONT="/usr/share/fonts/truetype/dejavu/DejaVuSans-Bold.ttf"
+FONT_REGULAR="/usr/share/fonts/truetype/dejavu/DejaVuSans.ttf"
+FONT_MONO="/usr/share/fonts/truetype/dejavu/DejaVuSansMono.ttf"
+
+scene() {
+  local id="$1"
+  local duration="$2"
+  shift 2
+  ffmpeg -y -f lavfi -i "color=c=$BG:s=1920x1080:d=$duration" \
+    -vf "$*" \
+    -c:v libx264 -pix_fmt yuv420p "$TEMP_DIR/scene${id}.mp4" 
+}
+
+echo "Scene 1: Hook"
+scene 1 8 \
+  "drawtext=text='Codra Code v0.2.3':fontsize=72:fontcolor=$PRIMARY:x=(w-text_w)/2:y=320:fontfile=$FONT,\
+  drawtext=text='Auth, Slash Commands & Model Picker':fontsize=36:fontcolor=$TEXT:x=(w-text_w)/2:y=440:fontfile=$FONT_REGULAR,\
+  drawtext=text='Local-first coding agent CLI from Talocode':fontsize=28:fontcolor=$DIM:x=(w-text_w)/2:y=520:fontfile=$FONT_REGULAR"
+
+echo "Scene 2: Install"
+scene 2 7 \
+  "drawtext=text='Install globally with npm':fontsize=42:fontcolor=$PRIMARY:x=360:y=260:fontfile=$FONT,\
+  drawtext=text='npm install -g @talocode/codra-code@0.2.3':fontsize=32:fontcolor=$TEXT:x=360:y=380:fontfile=$FONT_MONO,\
+  drawtext=text='✓ @talocode/codra-code@0.2.3 installed':fontsize=24:fontcolor=$SECONDARY:x=360:y=480:fontfile=$FONT_REGULAR"
+
+echo "Scene 3: Help"
+scene 3 7 \
+  "drawtext=text='Check available commands':fontsize=42:fontcolor=$PRIMARY:x=360:y=260:fontfile=$FONT,\
+  drawtext=text='codra-code --help':fontsize=32:fontcolor=$TEXT:x=360:y=380:fontfile=$FONT_MONO,\
+  drawtext=text='Commands - auth model status help':fontsize=24:fontcolor=$DIM:x=360:y=480:fontfile=$FONT_REGULAR"
+
+echo "Scene 4: Auth Status"
+scene 4 6 \
+  "drawtext=text='Check authentication status':fontsize=42:fontcolor=$PRIMARY:x=360:y=260:fontfile=$FONT,\
+  drawtext=text='codra-code auth status':fontsize=32:fontcolor=$TEXT:x=360:y=380:fontfile=$FONT_MONO,\
+  drawtext=text='Auth - Not signed in - Mode - Local':fontsize=24:fontcolor=$DIM:x=360:y=480:fontfile=$FONT_REGULAR"
+
+echo "Scene 5: Local Mode"
+scene 5 7 \
+  "drawtext=text='Local mode works without sign-in':fontsize=42:fontcolor=$PRIMARY:x=360:y=260:fontfile=$FONT,\
+  drawtext=text='codra-code --mock status':fontsize=32:fontcolor=$TEXT:x=360:y=380:fontfile=$FONT_MONO,\
+  drawtext=text='Provider - mock - Mode - Local - Ready':fontsize=24:fontcolor=$SECONDARY:x=360:y=480:fontfile=$FONT_REGULAR"
+
+echo "Scene 6: Model Picker"
+scene 6 7 \
+  "drawtext=text='Switch models with slash commands':fontsize=42:fontcolor=$PRIMARY:x=360:y=260:fontfile=$FONT,\
+  drawtext=text='codra-code --mock model':fontsize=32:fontcolor=$TEXT:x=360:y=380:fontfile=$FONT_MONO,\
+  drawtext=text='model - Select provider and model':fontsize=24:fontcolor=$DIM:x=360:y=480:fontfile=$FONT_REGULAR"
+
+echo "Scene 7: Architecture"
+scene 7 10 \
+  "drawtext=text='Hosted vs Local':fontsize=42:fontcolor=$ACCENT:x=360:y=220:fontfile=$FONT,\
+  drawtext=text='Hosted usage requires Tera Talocode account':fontsize=28:fontcolor=$TEXT:x=360:y=340:fontfile=$FONT_REGULAR,\
+  drawtext=text='Local mode remains open without auth':fontsize=28:fontcolor=$SECONDARY:x=360:y=400:fontfile=$FONT_REGULAR,\
+  drawtext=text='Local-first always':fontsize=24:fontcolor=$DIM:x=360:y=480:fontfile=$FONT_REGULAR"
+
+echo "Scene 8: CTA"
+scene 8 8 \
+  "drawtext=text='Codra Code v0.2.3':fontsize=72:fontcolor=$PRIMARY:x=(w-text_w)/2:y=300:fontfile=$FONT,\
+  drawtext=text='npm install -g @talocode/codra-code@0.2.3':fontsize=30:fontcolor=$TEXT:x=(w-text_w)/2:y=430:fontfile=$FONT_MONO,\
+  drawtext=text='github.com/talocode/codra':fontsize=34:fontcolor=$BLUE:x=(w-text_w)/2:y=520:fontfile=$FONT_REGULAR,\
+  drawtext=text='Local-first CLI - hosted API optional':fontsize=24:fontcolor=$DIM:x=(w-text_w)/2:y=590:fontfile=$FONT_REGULAR"
+
+cat > "$TEMP_DIR/concat.txt" << EOF
+file 'scene1.mp4'
+file 'scene2.mp4'
+file 'scene3.mp4'
+file 'scene4.mp4'
+file 'scene5.mp4'
+file 'scene6.mp4'
+file 'scene7.mp4'
+file 'scene8.mp4'
+EOF
+
+ffmpeg -y -f concat -safe 0 -i "$TEMP_DIR/concat.txt" -c copy "$TEMP_DIR/video_no_audio.mp4"
+
+# Add subtle background audio
+ffmpeg -y -f lavfi -i "sine=frequency=330:duration=50" -af "volume=0.015" -c:a aac "$TEMP_DIR/bg_audio.m4a"
+
+ffmpeg -y -i "$TEMP_DIR/video_no_audio.mp4" -i "$TEMP_DIR/bg_audio.m4a" \
+  -c:v copy -c:a aac -shortest "$OUTPUT"
+
+rm -rf "$TEMP_DIR"
+
+echo "Demo video created: $OUTPUT"
+ls -lh "$OUTPUT"

apps/code/docs/release/codra-code-v0.2.3-demo.mp4

@@ -0,0 +1,57 @@
+# Codra Code v0.2.3 Demo Script
+
+**Title:** Codra Code v0.2.3 — Auth, Slash Commands & Model Picker
+**Duration:** 45–70 seconds
+**Voiceover Tone:** Talocode founder/builder style, clear, calm, technical, terminal-first, not hype
+
+## Scene Breakdown
+
+### Scene 1: Hook (0:00-0:08)
+**Visual:** Dark terminal with Talocode branding, Codra Code logo/title
+**Caption:** Introducing Codra Code v0.2.3 — the local-first coding agent CLI from Talocode.
+**Voiceover:** "Introducing Codra Code v0.2.3 — the local-first coding agent CLI from Talocode."
+
+### Scene 2: Install (0:08-0:15)
+**Visual:** Terminal showing `npm install -g @talocode/codra-code@0.2.3` executing
+**Caption:** npm install -g @talocode/codra-code@0.2.3
+**Voiceover:** "Install globally with npm."
+
+### Scene 3: Help (0:15-0:22)
+**Visual:** Terminal showing `codra-code --help` output with command list
+**Caption:** codra-code --help
+**Voiceover:** "Check the available commands with --help."
+
+### Scene 4: Auth Status (0:22-0:28)
+**Visual:** Terminal showing `codra-code auth status` displaying current auth state
+**Caption:** codra-code auth status
+**Voiceover:** "Check your authentication status with auth status."
+
+### Scene 5: Local Mode (0:28-0:35)
+**Visual:** Terminal showing `codra-code --mock /status` displaying workspace status in local mode
+**Caption:** codra-code --mock /status
+**Voiceover:** "Local mode works without sign-in using the --mock flag."
+
+### Scene 6: Model Picker (0:35-0:42)
+**Visual:** Terminal showing `codra-code --mock /model` displaying model selection interface
+**Caption:** codra-code --mock /model
+**Voiceover:** "Switch models with the new /model slash command."
+
+### Scene 7: Hosted Gating Explanation (0:42-0:52)
+**Visual:** Split screen or text overlay showing local vs hosted mode distinction
+**Caption:** Hosted usage requires your Tera/Talocode account. Local mode remains open.
+**Voiceover:** "Hosted usage will require your Tera/Talocode account, while local mode remains open."
+
+### Scene 8: CTA (0:52-0:60)
+**Visual:** Terminal with install command + GitHub URL + Talocode branding
+**Caption:** Install from npm or check the GitHub release.
+**Voiceover:** "Install from npm or check the GitHub release."
+
+## Technical Notes
+
+- Use dark terminal aesthetic (Talocode style)
+- Ensure terminal commands are clearly readable
+- No fake command results - show actual CLI output
+- No secrets or tokens displayed
+- No production auth claims beyond foundation/adapter
+- Preserve local-first positioning in all visuals
+- File size should be reasonable for web distribution

apps/code/docs/release/v0.2.3-demo-script.md

@@ -0,0 +1,80 @@
+# Codra Code v0.2.3 Demo Shotlist
+
+## Video Specifications
+- **Format:** MP4
+- **Resolution:** 1920x1080 (16:9)
+- **Frame Rate:** 30fps
+- **Duration:** 45-70 seconds
+- **Style:** Dark terminal, Talocode branding
+- **Audio:** Voiceover + optional background ambient
+
+## Shot List
+
+### Shot 1: Title Card (0:00-0:08)
+- **Visual:** Dark terminal background with Codra Code logo/title
+- **Text:** "Codra Code v0.2.3 — Auth, Slash Commands & Model Picker"
+- **Duration:** 8 seconds
+- **Audio:** Voiceover intro
+
+### Shot 2: Install Command (0:08-0:15)
+- **Visual:** Terminal window executing `npm install -g @talocode/codra-code@0.2.3`
+- **Text:** Command visible in terminal, success message
+- **Duration:** 7 seconds
+- **Audio:** Voiceover explaining install
+
+### Shot 3: Help Command (0:15-0:22)
+- **Visual:** Terminal showing `codra-code --help` output
+- **Text:** Command list displayed clearly
+- **Duration:** 7 seconds
+- **Audio:** Voiceover explaining help
+
+### Shot 4: Auth Status (0:22-0:28)
+- **Visual:** Terminal showing `codra-code auth status` output
+- **Text:** Current auth state displayed
+- **Duration:** 6 seconds
+- **Audio:** Voiceover explaining auth status
+
+### Shot 5: Local Mode (0:28-0:35)
+- **Visual:** Terminal showing `codra-code --mock /status` output
+- **Text:** Workspace status in local mode
+- **Duration:** 7 seconds
+- **Audio:** Voiceover explaining local mode
+
+### Shot 6: Model Picker (0:35-0:42)
+- **Visual:** Terminal showing `codra-code --mock /model` output
+- **Text:** Model selection interface
+- **Duration:** 7 seconds
+- **Audio:** Voiceover explaining model picker
+
+### Shot 7: Architecture Explanation (0:42-0:52)
+- **Visual:** Split screen or text overlay showing local vs hosted distinction
+- **Text:** "Hosted usage requires Tera/Talocode account. Local mode remains open."
+- **Duration:** 10 seconds
+- **Audio:** Voiceover explaining architecture
+
+### Shot 8: CTA (0:52-0:60)
+- **Visual:** Terminal with install command + GitHub URL
+- **Text:** "Install from npm: npm install -g @talocode/codra-code@0.2.3"
+- **Text:** "GitHub: github.com/talocode/codra"
+- **Duration:** 8 seconds
+- **Audio:** Voiceover CTA
+
+## Visual Style Guidelines
+- **Terminal:** Dark background (#1a1a1a or similar), light text (#e0e0e0)
+- **Font:** Monospace (Fira Code, JetBrains Mono, or similar)
+- **Accent Color:** Talocode brand color (if available)
+- **Captions:** Clear, readable, bottom of screen
+- **Transitions:** Smooth fades between shots
+
+## Audio Guidelines
+- **Voiceover:** Calm, technical, founder-style
+- **Background:** Minimal ambient (optional)
+- **Volume:** Voiceover clear and prominent
+- **Timing:** Voiceover synced with visual changes
+
+## Technical Constraints
+- No fake command results
+- No secrets or tokens
+- No production auth claims beyond foundation
+- Preserve local-first positioning
+- File size under 50MB preferred for web distribution

apps/code/docs/release/v0.2.3-demo-shotlist.md

@@ -0,0 +1,76 @@
+# Codra Code v0.2.3 — Auth, Slash Commands & Model Picker
+
+Codra Code is Talocode's local-first coding agent CLI. v0.2.3 improves the terminal coding experience with Tera/Talocode auth foundation, hosted usage gating, slash commands, model picker, status/auth commands, and cleaner release validation.
+
+## Install
+
+### Linux/macOS
+
+```bash
+npm install -g @talocode/codra-code@0.2.3
+codra-code --help
+codra-code auth status
+codra-code --mock /status
+```
+
+### Windows PowerShell
+
+```bash
+npm install -g @talocode/codra-code@0.2.3
+codra-code --help
+codra-code auth status
+codra-code --mock /status
+```
+
+### Alternative npx usage
+
+```bash
+npx @talocode/codra-code@0.2.3 --help
+npx @talocode/codra-code@0.2.3 auth status
+```
+
+## What Changed
+
+- **Tera/Talocode auth foundation** - Auth system foundation for Tera/Talocode accounts
+- **Hosted usage gating** - Hosted coding usage blocked until sign-in with `codra login`
+- **Local-first mode preserved** - Local/mock/Ollama usage remains available without auth
+- **Slash command picker** - Press `/` to open command picker
+- **Model picker** - `/model` provider and model selector
+- **Status command** - `/status` displays workspace/auth/model/mode information
+- **Auth commands** - `/auth`, `/login`, `/logout` for account management
+- **Improved terminal header** - Cleaner, more informative CLI header
+- **Safer session metadata** - Improved local session metadata handling
+- **Package-level validation** - Clean release validation pipeline
+
+## Security & Safety
+
+- No tokens printed to console
+- No raw secrets in logs
+- Local-first mode preserved without auth
+- No billing/payment integration in this release
+- No production Tera credit integration in this release
+
+## Validation
+
+- ✅ Typecheck passed
+- ✅ Tests 8/8 passed
+- ✅ Build passed
+- ✅ Local CLI smoke test passed
+- ✅ npm pack dry-run passed
+- ✅ npm published as `@talocode/codra-code@0.2.3`
+
+## Known Limitations
+
+- Real Tera production auth backend may require final integration
+- Some slash commands are placeholders for future features
+- Hosted billing/credits are not live yet
+- This release focuses on CLI/auth/interface foundation
+- Production auth/billing capabilities will ship in future releases
+
+## Documentation
+
+Full documentation available at [github.com/talocode/codra](https://github.com/talocode/codra)
+
+## License
+
+MIT - see LICENSE file for details