@ginkoai/cli 2.1.6-beta.0 → 2.1.6

package/dist/templates/skills/skills/ginko/commands-reference.md

@@ -1,221 +0,0 @@
-# Ginko CLI Commands Reference
-
-Complete reference for all ginko CLI commands.
-
-## Session Commands
-
-### `ginko start [sessionId]`
-Start or resume a session with event-based context loading.
-- Loads context from `.ginko/sessions/[user]/`
-- Shows active sprint and next task
-- Warns about uncommitted files
-
-### `ginko status`
-Show current session status.
-
-### `ginko handoff [message]`
-Pause current session and create handoff document.
-- Archives previous session
-- Creates continuity document for next session
-
-### `ginko log [description]`
-Log an event to the current session (defensive logging).
-
-### `ginko compact`
-Reduce context size by removing stale information.
-
-## Task Management
-
-### `ginko task complete <taskId>`
-Mark task as complete. Updates knowledge graph (syncs to dashboard).
-- Options: `--cascade` (auto-complete parent if all siblings done)
-
-### `ginko task start <taskId>`
-Mark task as in progress.
-
-### `ginko task pause <taskId>`
-Return task to not_started state.
-
-### `ginko task block <taskId> [reason]`
-Block task with reason. Prompts for reason if not provided.
-
-### `ginko task show <taskId>`
-Show current task status.
-
-## Sprint Management
-
-### `ginko sprint start <sprintId>`
-Start sprint (planned → active).
-
-### `ginko sprint complete <sprintId>`
-Complete sprint (active → complete).
-
-### `ginko sprint pause <sprintId>`
-Pause sprint (active → paused).
-
-### `ginko sprint status show <sprintId>`
-Show current sprint status.
-
-### `ginko sprint deps`
-Visualize task dependencies as a tree.
-
-## Knowledge Graph
-
-### `ginko graph init`
-Initialize knowledge graph for your project.
-
-### `ginko graph load [options]`
-Upload documents to knowledge graph.
-- `--docs-only`: Load ADRs and PRDs only
-- `--extended-only`: Load patterns, gotchas, sessions only
-- `--force`: Reload all documents even if unchanged
-
-### `ginko graph status`
-Show graph statistics and health.
-
-### `ginko graph health`
-Show graph reliability metrics (success rate, latency, retries).
-
-### `ginko graph query <text>`
-Search documents using semantic similarity.
-- Options: `--limit N`, `--type <TYPE>`
-
-### `ginko graph explore <documentId>`
-Explore document and its connections.
-
-### `ginko graph migrate <migration>`
-Run graph migrations.
-
-## Team & Assignment
-
-### `ginko assign <taskIdOrEmail> [email]`
-Assign tasks to team members.
-- Updates both graph and sprint markdown
-- Options: `--sprint <id> --all` (assign all tasks in sprint)
-
-### `ginko sync [options]`
-Pull dashboard knowledge edits to local git.
-- `--preview`: Preview without syncing
-- `--dry-run`: Preview what files would sync
-- `--force`: Overwrite local files
-- `--type <type>`: Sync only specific type (ADR, PRD, Pattern, etc.)
-- `--no-commit`: Sync without committing
-
-### `ginko team-activity [user]`
-View team activity from user-namespaced session logs.
-
-### `ginko invite [email]`
-Invite collaborators to join your team.
-
-### `ginko join [code]`
-Join a team using an invitation code.
-
-## Planning & Architecture
-
-### `ginko charter`
-Create and manage project charter (AI-assisted).
-
-### `ginko epic`
-Create and manage epics with status tracking.
-
-### `ginko sprint [intent]`
-Sprint management and planning commands.
-
-### `ginko plan [feature]`
-Create phased implementation plan with acceptance criteria.
-
-### `ginko architecture [decision]`
-Design mode for crafting ADRs with AI enhancement.
-
-### `ginko roadmap`
-View product roadmap (Now/Next/Later priority lanes).
-
-### `ginko backlog`
-Manage git-native backlog items.
-
-### `ginko feature <description>`
-Quick create a feature (shortcut for backlog create feature).
-
-### `ginko story <description>`
-Quick create a story (shortcut for backlog create story).
-
-## Development Tools
-
-### `ginko ship [message]`
-AI-enhanced shipping with smart commit messages and PR descriptions.
-
-### `ginko verify <taskId>`
-Verify task completion by running acceptance criteria checks.
-
-### `ginko vibecheck [concern]`
-Pause moment for recalibration - conversational check-in.
-
-### `ginko capture [description]`
-Capture a learning, discovery, or important context.
-
-### `ginko explore [topic]`
-Collaborative thinking mode for exploring problems and solutions.
-
-### `ginko reflect <intent>`
-Universal reflection pattern for AI-enhanced content generation.
-
-## Multi-Agent
-
-### `ginko orchestrate`
-Run as supervisor agent to coordinate multi-agent task execution.
-
-### `ginko agent`
-Manage AI agents for multi-agent collaboration.
-
-### `ginko checkpoint`
-Manage checkpoints for task rollback and recovery.
-
-### `ginko dlq`
-Manage Dead Letter Queue (failed events).
-
-### `ginko escalation`
-Manage human escalations for multi-agent collaboration.
-
-### `ginko notifications`
-Manage notification hooks for human observability.
-
-## Authentication
-
-### `ginko login`
-Authenticate CLI with GitHub via Supabase OAuth.
-
-### `ginko logout`
-Clear local authentication session.
-
-### `ginko whoami`
-Display current authentication status and user information.
-
-## Configuration
-
-### `ginko init`
-Initialize Ginko in your project (sets up local structure + cloud graph).
-
-### `ginko config [key] [value]`
-Manage Ginko configuration.
-
-### `ginko context`
-Manage session context.
-
-## IDE Integration
-
-### `ginko init-cursor`
-Generate Cursor setup preview or apply it to the repository.
-
-### `ginko uninstall-cursor`
-Remove Cursor integration.
-
-### `ginko init-copilot`
-Generate GitHub Copilot setup preview or apply to repository.
-
-### `ginko uninstall-copilot`
-Remove GitHub Copilot integration.
-
-## Migration
-
-### `ginko migrate`
-Migration utilities for syncing markdown to graph.

package/dist/templates/skills/skills/pull.md

@@ -1,56 +0,0 @@
-# Pull Skill (ADR-077)
-
-## Purpose
-Pull dashboard edits from the Ginko Cloud knowledge graph to local git repository.
-
-## When to Use
-- At the start of a session when team context may be stale
-- When `ginko start` shows staleness warnings
-- When user requests updates from dashboard
-- After team members have made edits in the dashboard
-
-## Command Reference
-
-```bash
-# Pull all changes from graph
-ginko pull
-
-# Pull specific entity types
-ginko pull sprint              # Pull sprint changes (status updates)
-ginko pull adr                 # Pull ADR edits
-ginko pull epic                # Pull epic changes
-
-# Options
-ginko pull --dry-run           # Preview without pulling
-ginko pull --force             # Overwrite local with graph versions
-```
-
-## Options
-
-| Flag | Description | Default |
-|------|-------------|---------|
-| `--dry-run` | Preview what would be pulled | false |
-| `--force` | Overwrite local files with graph versions | false |
-
-## Error Handling
-
-| Error | Action |
-|-------|--------|
-| `Not authenticated` | Prompt: Run `ginko login` |
-| `Graph not initialized` | Prompt: Run `ginko graph init` |
-| Conflict detected | Interactive resolution (use-graph, use-local, skip) |
-| 5xx server error | Retry with exponential backoff |
-
-## Behavioral Rules
-
-1. **Pull at session start** - When `ginko start` shows staleness, auto-pull
-2. **Content conflicts: local wins** - Per ADR-060, content in git is authoritative
-3. **State conflicts: graph wins** - Status, assignments are graph-authoritative
-4. **Never use deprecated alternatives** - Do not use `ginko sync` (deprecated)
-5. **After pull, suggest push** - If local has unpushed changes, suggest `ginko push`
-
-## Anti-Patterns (DO NOT)
-
-- Do NOT use `ginko sync` (deprecated, use `ginko pull`)
-- Do NOT use curl/fetch to hit graph API directly
-- Do NOT skip pull when team context is stale

package/dist/templates/skills/skills/push.md

@@ -1,73 +0,0 @@
-# Push Skill (ADR-077)
-
-## Purpose
-Push local content changes to the Ginko Cloud knowledge graph using git-integrated change detection.
-
-## When to Use
-- After creating or modifying content files (epics, sprints, ADRs, charters, patterns, gotchas)
-- After `ginko handoff` to ensure all work is synced
-- After `ginko task complete` / `ginko sprint complete` to persist state
-- When the orchestrator detects unpushed content changes
-- When user requests sync to graph
-
-## Command Reference
-
-```bash
-# Push all changes since last push
-ginko push
-
-# Push specific entity types
-ginko push epic                   # All changed epics
-ginko push epic EPIC-001          # Specific epic
-ginko push sprint e001_s01        # Specific sprint
-ginko push charter                # Project charter
-ginko push adr                    # All changed ADRs
-
-# Options
-ginko push --dry-run              # Preview without pushing
-ginko push --force                # Overwrite graph content
-ginko push --all                  # Push all (not just changes)
-ginko push --no-events            # Skip event files
-```
-
-## Options
-
-| Flag | Description | Default |
-|------|-------------|---------|
-| `--dry-run` | Preview what would be pushed | false |
-| `--force` | Overwrite graph even if conflicts | false |
-| `--all` | Push all content files, ignoring change detection | false |
-| `--no-events` | Skip pushing event JSONL files | false |
-
-## Error Handling
-
-| Error | Action |
-|-------|--------|
-| `Not authenticated` | Prompt: Run `ginko login` |
-| `Graph not initialized` | Prompt: Run `ginko graph init` |
-| 5xx server error | Retry with exponential backoff (handled by API client) |
-| 4xx client error | Report to user, do not retry |
-| Network error | Retry up to 3 times |
-
-## Behavioral Rules
-
-1. **Always push after entity creation** - When an epic, sprint, charter, or ADR is created, push immediately
-2. **Push is non-blocking for auto-push** - When dispatched as a subagent, run in background
-3. **Prefer targeted push** - Use `ginko push epic` instead of `ginko push` when you know the entity type
-4. **Never use deprecated alternatives** - Do not use `ginko graph load` or `--sync` flags
-5. **Report results concisely** - Show file count, task count, and event count
-
-## Anti-Patterns (DO NOT)
-
-- Do NOT use `ginko graph load` (deprecated, use `ginko push --all`)
-- Do NOT use `ginko epic --sync` (deprecated, use `ginko push epic`)
-- Do NOT use `ginko charter --sync` (deprecated, use `ginko push charter`)
-- Do NOT use curl/fetch to hit graph API directly
-- Do NOT skip push after creating content
-
-## Exit Codes
-
-| Code | Meaning |
-|------|---------|
-| 0 | Push completed successfully |
-| 1 | Push failed (auth, config, or API error) |