zaileys 2.2.7 → 3.0.0

package/.gsd/templates/sprint.md

@@ -0,0 +1,57 @@
+# Sprint {N} — {Sprint Name}
+
+> **Duration**: YYYY-MM-DD to YYYY-MM-DD
+> **Status**: In Progress | Complete
+
+## Goal
+{One sentence describing what this sprint aims to achieve.}
+
+## Scope
+
+### Included
+- {Feature/task 1}
+- {Feature/task 2}
+- {Feature/task 3}
+
+### Explicitly Excluded
+- {Out of scope item 1}
+- {Out of scope item 2}
+
+## Tasks
+
+| Task | Assignee | Status | Est. Hours |
+|------|----------|--------|------------|
+| {Task 1} | {who} | ⬜ Todo | {hours} |
+| {Task 2} | {who} | 🔄 In Progress | {hours} |
+| {Task 3} | {who} | ✅ Done | {hours} |
+
+## Daily Log
+
+### Day 1 (YYYY-MM-DD)
+- {What was accomplished}
+- {Blockers encountered}
+
+### Day 2 (YYYY-MM-DD)
+- {What was accomplished}
+- {Blockers encountered}
+
+## Risks & Blockers
+
+| Risk | Impact | Mitigation |
+|------|--------|------------|
+| {Risk 1} | {High/Med/Low} | {What can be done} |
+
+## Retrospective (end of sprint)
+
+### What Went Well
+- {Positive outcome 1}
+
+### What Could Improve
+- {Area for improvement 1}
+
+### Action Items
+- [ ] {Action to take in next sprint}
+
+---
+
+*Last updated: <!-- date -->*

package/.gsd/templates/stack.md

@@ -0,0 +1,62 @@
+# Technology Stack
+
+> Auto-generated by /map on <!-- date -->
+
+## Runtime
+
+| Technology | Version | Purpose |
+|------------|---------|---------|
+| {Language} | {version} | {purpose} |
+| {Framework} | {version} | {purpose} |
+| {Database} | {version} | {purpose} |
+
+## Core Technologies
+
+### {Category 1}
+| Feature | System | Purpose |
+|---------|--------|---------|
+| {Feature} | {System/Location} | {Purpose} |
+
+### {Category 2}
+| Directory | Files | Purpose |
+|-----------|-------|---------|
+| `{path}` | {count} | {purpose} |
+
+## Dependencies
+
+### External Dependencies
+
+| Package | Version | Purpose |
+|---------|---------|---------|
+| {package} | {version} | {purpose} |
+
+### Internal Dependencies
+
+| Component | Depends On | Purpose |
+|-----------|------------|---------|
+| {Component A} | {Component B} | {Why dependency exists} |
+
+## Infrastructure
+
+| Service | Provider | Purpose |
+|---------|----------|---------|
+| {Service} | {Provider} | {Purpose} |
+
+**Repository:** {repository URL}
+
+## Configuration
+
+| Variable | Purpose | Location |
+|----------|---------|----------|
+| {VAR_NAME} | {What it controls} | {Where it's set} |
+
+## File Size Inventory
+
+| Category | Count | Total Lines (approx) |
+|----------|-------|---------------------|
+| {Category} | {count} | {lines} |
+| **Total** | **{total}** | **{total_lines}** |
+
+---
+
+*Last updated: <!-- date -->*

package/.gsd/templates/state.md

@@ -0,0 +1,92 @@
+# State Template
+
+Template for `.gsd/STATE.md` — project memory across sessions.
+
+---
+
+## File Template
+
+```markdown
+---
+updated: [ISO timestamp]
+---
+
+# Project State
+
+## Current Position
+
+**Milestone:** {name}
+**Phase:** {N} - {name}
+**Status:** {planning | executing | verifying | blocked}
+**Plan:** {current plan if executing}
+
+## Last Action
+
+{What was just completed}
+
+## Next Steps
+
+1. {Immediate next action}
+2. {Following action}
+3. {Third action if known}
+
+## Active Decisions
+
+Decisions made that affect current work:
+
+| Decision | Choice | Made | Affects |
+|----------|--------|------|---------|
+| {what} | {choice} | {date} | {phases/plans} |
+
+## Blockers
+
+{None if clear}
+
+- [ ] {Blocker 1}: {resolution approach}
+- [ ] {Blocker 2}: {resolution approach}
+
+## Concerns
+
+Things to watch but not blocking:
+
+- {Concern 1}
+- {Concern 2}
+
+## Session Context
+
+{Any context the next session needs to know}
+```
+
+---
+
+## Update Rules
+
+**Update STATE.md after:**
+- Every completed task
+- Every decision made
+- Any blocker identified
+- Session end/pause
+
+**What to update:**
+- `updated` timestamp
+- Current Position
+- Last Action
+- Next Steps
+
+**Keep it lean:**
+- STATE.md is read frequently
+- Only current context, not history
+- History goes in JOURNAL.md
+
+---
+
+## Resume Protocol
+
+When starting a new session:
+
+1. Read STATE.md first
+2. Understand current position
+3. Check blockers/concerns
+4. Continue from Next Steps
+
+The STATE.md is the "save game" for the project.

package/.gsd/templates/state_snapshot.md

@@ -0,0 +1,132 @@
+# State Snapshot Template
+
+Template for wave summaries and session state captures.
+
+---
+
+## When to Use
+
+Create a state snapshot:
+- After completing each wave
+- Before pausing work
+- After 3 debugging failures
+- When switching models mid-session
+- At any significant milestone
+
+---
+
+## Template
+
+```markdown
+---
+wave: {N}
+phase: {phase number}
+created: {ISO timestamp}
+status: {complete | partial | blocked}
+---
+
+# Wave {N} State Snapshot
+
+## Objective
+
+{What this wave aimed to accomplish — 1-2 sentences}
+
+## Changes Realized
+
+- {Change 1}
+- {Change 2}
+- {Change 3}
+
+## Files Touched
+
+| File | Change Type | Description |
+|------|-------------|-------------|
+| {path/to/file1} | created | {brief description} |
+| {path/to/file2} | modified | {brief description} |
+| {path/to/file3} | deleted | {brief description} |
+
+## Verification Results
+
+| Check | Command | Result |
+|-------|---------|--------|
+| {Test 1} | `{command}` | ✅ Passed |
+| {Test 2} | `{command}` | ✅ Passed |
+| {Test 3} | `{command}` | ❌ Failed: {reason} |
+
+## Commits in This Wave
+
+| Hash | Message |
+|------|---------|
+| {abc123} | {commit message 1} |
+| {def456} | {commit message 2} |
+
+## Risks & Technical Debt
+
+{None if clear}
+
+- ⚠️ {Risk or debt item 1}
+- ⚠️ {Risk or debt item 2}
+
+## TODO for Next Wave
+
+1. {Next task 1}
+2. {Next task 2}
+3. {Next task 3}
+
+## Context for Fresh Session
+
+{Any information the next session needs — decisions made, blockers encountered, hypotheses to test}
+
+## Token Usage (Optional)
+
+| Metric | Value |
+|--------|-------|
+| Files loaded | {count} |
+| Est. tokens | {number} |
+| Budget used | {percentage}% |
+| Compression | {yes/no} |
+
+{Notes on token efficiency for this wave}
+```
+
+---
+
+## Minimal Snapshot (Debug Session)
+
+For quick state dumps during debugging:
+
+```markdown
+# Debug State Snapshot
+
+**Time:** {timestamp}
+**Problem:** {what you're debugging}
+
+**Tried:**
+1. {approach 1} → {result}
+2. {approach 2} → {result}
+3. {approach 3} → {result}
+
+**Current Hypothesis:** {theory}
+
+**Files Involved:**
+- {file1}
+- {file2}
+
+**Recommended Next:** {suggested approach for fresh session}
+```
+
+---
+
+## Integration with STATE.md
+
+State snapshots are point-in-time captures. After creating a snapshot:
+
+1. Update STATE.md with current position
+2. Reference the snapshot in SESSION Context
+3. Commit both together
+
+STATE.md is current state; snapshots are historical records.
+
+---
+
+*Part of GSD methodology. See PROJECT_RULES.md for wave execution rules.*

package/.gsd/templates/todo.md

@@ -0,0 +1,32 @@
+# TODO.md — Pending Items
+
+> Quick capture of ideas, tasks, and issues.
+>
+> Use `/add-todo` to add items, `/check-todos` to view.
+
+## Format
+
+```markdown
+- [ ] Description `priority` — YYYY-MM-DD
+- [x] Completed item `priority` — YYYY-MM-DD ✓ YYYY-MM-DD
+```
+
+## Priority Levels
+
+| Level | Use For |
+|-------|---------|
+| `high` 🔴 | Blocking issues, urgent fixes |
+| `medium` 🟡 | Normal priority (default) |
+| `low` 🟢 | Nice-to-have, future ideas |
+
+---
+
+## Items
+
+<!-- Active todos below -->
+
+- [ ] {Example todo item} `medium` — YYYY-MM-DD
+
+---
+
+*Last updated: <!-- date -->*

package/.gsd/templates/token_report.md

@@ -0,0 +1,79 @@
+# Token Report Template
+
+Template for documenting token usage per wave or session.
+
+---
+
+## Template
+
+```markdown
+---
+wave: {N}
+phase: {phase number}
+created: {ISO timestamp}
+---
+
+# Token Usage Report
+
+## Summary
+
+| Metric | Value |
+|--------|-------|
+| Files loaded | {count} |
+| Estimated tokens | {number} |
+| Budget usage | {percentage}% |
+| Compression applied | {yes/no} |
+
+## Files Loaded
+
+| File | Lines | Est. Tokens | Reason |
+|------|-------|-------------|--------|
+| {path/to/file1} | {N} | {N} | {why loaded} |
+| {path/to/file2} | {N} | {N} | {why loaded} |
+
+## Compression Applied
+
+| File | Before | After | Savings |
+|------|--------|-------|---------|
+| {file} | {N} | summary | {N} tokens |
+
+## Efficiency Analysis
+
+### What Worked Well
+- {Strategy that saved tokens}
+
+### Could Improve
+- {Opportunity for optimization}
+
+### Recommendations
+- {Suggestion for next wave}
+```
+
+---
+
+## When to Create
+
+Create a token report:
+- After completing a wave with high token usage
+- When budget exceeds 50%
+- For debugging session performance
+- During milestone retrospectives
+
+---
+
+## Quick Report (Minimal)
+
+For simple tracking:
+
+```markdown
+## Token Report: Wave {N}
+
+- Files: {count}
+- Tokens: ~{number}
+- Budget: {X}%
+- Status: [OK|WARNING|CRITICAL]
+```
+
+---
+
+*Part of GSD v1.6 Token Optimization.*

package/.gsd/templates/user-setup.md

@@ -0,0 +1,116 @@
+# User Setup Template
+
+Template for user setup instructions when external services are needed.
+
+---
+
+## File Template
+
+```markdown
+---
+phase: {N}
+plan: {M}
+type: user-setup
+---
+
+# User Setup Required
+
+## Overview
+
+This plan requires manual setup that the AI cannot perform.
+
+**Time estimate:** {X minutes}
+**Blocking:** Plan cannot proceed until complete
+
+---
+
+## Setup Steps
+
+### 1. {Service Name}
+
+**Why needed:** {Purpose in the project}
+
+**Create account:**
+- Go to: {URL}
+- Sign up with: {recommendations}
+
+**Get credentials:**
+1. Navigate to: {dashboard location}
+2. Find: {API keys section}
+3. Create: {what to create}
+
+**Add to project:**
+```powershell
+# Add to .env.local
+{ENV_VAR}=your_key_here
+```
+
+**Verify:**
+```powershell
+# Test the connection
+{verification command}
+```
+
+---
+
+### 2. {Another Service}
+
+**Why needed:** {Purpose}
+
+**Steps:**
+1. {Step 1}
+2. {Step 2}
+3. {Step 3}
+
+**Environment variables:**
+```
+{VAR_1}=value
+{VAR_2}=value
+```
+
+---
+
+## Dashboard Configuration
+
+Some things require manual dashboard setup:
+
+| Service | Task | Location | Notes |
+|---------|------|----------|-------|
+| {service} | {task} | {where} | {notes} |
+
+---
+
+## Verification Checklist
+
+Before continuing, verify:
+
+- [ ] All environment variables set
+- [ ] All accounts created
+- [ ] All dashboard configurations complete
+- [ ] Verification commands pass
+
+---
+
+## When Complete
+
+Type "done" or "setup complete" to continue with execution.
+```
+
+---
+
+## Guidelines
+
+**Include only what AI cannot do:**
+- Account creation (requires human identity)
+- Secret retrieval (protected behind login)
+- Dashboard configuration (no API available)
+- Payment method setup
+- 2FA enrollment
+
+**Do NOT include:**
+- npm install (AI can do)
+- File creation (AI can do)
+- Configuration file edits (AI can do)
+- API calls (AI can do)
+
+**Keep minimal** — every manual step slows down execution.

package/.husky/commit-msg

@@ -0,0 +1 @@
+npx --no -- commitlint --edit ${1}

package/.husky/pre-commit

@@ -0,0 +1 @@
+pnpm build

package/LICENSE

@@ -1,21 +1,21 @@
-MIT License
-
-Copyright (c) 2025 zaadevofc
-
-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) 2025 zaadevofc
+
+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.