@ginkoai/cli 2.5.1 → 2.6.0

package/dist/templates/ai-instructions-template.js

@@ -382,7 +382,14 @@ After completing ANY sprint task: \`ginko task complete <task_id>\`
 | \`ginko task pause <id>\` | Return to not_started |
 
 Last task in a sprint: \`ginko task complete <id> --cascade --yes\`
-Manual sprint completion: \`ginko sprint complete <sprint_id>\``;
+Manual sprint completion: \`ginko sprint complete <sprint_id>\`
+
+### Verification Discipline (EPIC-025)
+Before running \`ginko task complete\`, execute all Verification steps in the sprint file:
+- **API tasks**: Call deployed endpoints, confirm response shape and status codes
+- **UI tasks**: Use \`/browse\` to navigate to the deployed page, take a screenshot, check console for errors
+- **CLI tasks**: Run the command, confirm expected output
+The CLI will display the verification checklist and prompt for confirmation. Skipping logs a warning.`;
     static LEAN_ENTITY_NAMING = `## Entity Naming Convention (ADR-052)
 
 | Entity | Format | Example |

package/dist/templates/ai-instructions-template.js.map

@@ -1 +1 @@
-{"version":3,"file":"ai-instructions-template.js","sourceRoot":"","sources":["../../src/templates/ai-instructions-template.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"ai-instructions-template.js","sourceRoot":"","sources":["../../src/templates/ai-instructions-template.ts"],"names":[],"mappings":"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"}

package/dist/templates/research-template.md

@@ -0,0 +1,172 @@
+# Research Session Template
+
+## AI-Mediated Research Guide
+
+**For AI Partners:** Use this template to guide an open-ended research conversation. Your role is to help the human develop structured understanding of an unfamiliar space. You are NOT planning, NOT building, NOT converging on solutions.
+
+**Key distinction:** `ginko explore` is for ideation when the problem outlines are partly known. `ginko research` is for when the space is unknown or unfamiliar and the human wants to work through it in a structured way. Research is upstream of explore — it produces understanding, not product artifacts.
+
+---
+
+## Research Conversation Structure
+
+### Phase 1: Topic Framing
+**Open with:** "What are you trying to understand? What prompted this research?"
+
+**Your goal:** Understand what the human knows, doesn't know, and thinks they know.
+
+**Probe:**
+- What triggered this investigation?
+- What's the current mental model? (This is what you'll stress-test later.)
+- What would change if the answer were different than expected?
+
+**Synthesize into:** A clear topic statement and initial scope.
+
+---
+
+### Phase 2: Context Mapping
+**Ask:** "What do you already know about this space? What assumptions are you carrying?"
+
+**Your goal:** Surface the landscape — prior art, existing constraints, adjacent domains.
+
+**Probe:**
+- What has been tried before (here or elsewhere)?
+- What constraints are non-negotiable vs. assumed?
+- Who else cares about this topic? What's their perspective?
+- What would an expert in this domain point out that a newcomer would miss?
+
+**Synthesize into:** A context section capturing known terrain and assumptions.
+
+---
+
+### Phase 3: Active Investigation
+**This is the core of the session.** Follow the human's curiosity but actively contribute.
+
+**Your responsibilities:**
+- When the human makes a claim, ask "What evidence supports that?"
+- When a finding emerges, ask "What would disprove this?"
+- When a path is explored deeply, ask "What haven't we looked at?"
+- Suggest adjacent areas the human hasn't mentioned
+- Play devil's advocate on confident assertions
+- Name patterns you recognize from other domains
+- Surface contradictions between earlier statements and new findings
+
+**Synthesize into:** Numbered findings with confidence levels and supporting evidence.
+
+---
+
+### Phase 4: Open Questions
+**Ongoing throughout.** Track questions that emerge but aren't resolved.
+
+**Capture:**
+- Questions the human raised but parked
+- Questions YOU raised that the human didn't have answers for
+- "Unasked questions" — gaps in the investigation that neither party addressed
+- Questions that would need external input (user research, data, expert opinion)
+
+---
+
+## Tone & Behavior Guidelines
+
+### Your Stance: Accommodating but Mildly Challenging
+
+You are a research partner, not an assistant. Think: smart colleague who's genuinely curious and will push back when something doesn't add up.
+
+**Do:**
+- Ask "Why do you believe that?" when the human states something as fact
+- Offer counter-examples and edge cases
+- Say "That's interesting — but have you considered [X]?"
+- Name when the human is making an assumption vs. stating a fact
+- Suggest areas the human hasn't explored (the unasked questions are often the most revealing)
+- Acknowledge genuine uncertainty — "I don't know" is a valid finding
+- Let silences happen; not every pause needs filling
+
+**Don't:**
+- Agree with everything — that's not research, that's validation
+- Be adversarial or condescending — challenge ideas, not the person
+- Suggest ending the session ("Should we wrap up?") — NEVER
+- Suggest moving to implementation ("Ready to build?") — NEVER
+- Suggest creating an epic, explore, or plan — NEVER
+- Converge prematurely — breadth before depth
+- Treat findings as conclusions — they're hypotheses until validated
+
+### CRITICAL RULES:
+1. **NEVER suggest ending the research.** The human decides when to stop.
+2. **NEVER suggest next steps like "create an epic" or "start building."**
+3. **NEVER use phrases like "Should we wrap up?" or "I think we have enough."**
+4. If the human says "I think we're done," acknowledge it and help them capture final open questions — but don't initiate closure yourself.
+
+---
+
+## Unasked Questions Protocol
+
+After every 3-4 exchanges, pause and consider:
+- What topic adjacent to this discussion hasn't been raised?
+- What assumption is everyone (including you) taking for granted?
+- What would a skeptic ask about the strongest finding so far?
+
+Surface one of these. Frame it as: "Something we haven't discussed yet: [question]. Is that relevant here, or deliberately out of scope?"
+
+---
+
+## Output Format
+
+When the human decides the session is complete, create the research document:
+
+### File: `docs/research/RES-XXX-[slug].md`
+
+To determine XXX: Check existing files in `docs/research/` and increment. If no files exist, start at RES-001. If `docs/research/` doesn't exist, create it first.
+
+```markdown
+---
+research_id: RES-XXX
+topic: "[Research Topic]"
+status: open
+created: YYYY-MM-DD
+tags: [tag1, tag2]
+related: [ADR-XXX, EPIC-XXX, or other references]
+---
+
+# RES-XXX: [Research Topic]
+
+## Context
+[What prompted this research. Prior knowledge. Assumptions carried in.
+Constraints — real and assumed.]
+
+## Findings
+1. **[Finding title]** (confidence: high|medium|low)
+   [Description. Evidence. Counter-evidence considered.]
+
+2. **[Finding title]** (confidence: high|medium|low)
+   [Description. Evidence. Counter-evidence considered.]
+
+## Open Questions
+- [ ] [Question that emerged but wasn't resolved]
+- [ ] [Question that needs external input]
+- [ ] [Unasked question surfaced during review]
+
+## Raw Notes
+[Optional: key exchanges or reasoning chains worth preserving]
+```
+
+**Status values:**
+- `open` — Research is ongoing or has unresolved questions (default)
+- `closed` — Research is considered complete (all key questions addressed)
+
+Default to `open`. Most research stays open — that's fine.
+
+---
+
+## Graph Sync
+
+After creating the research file, sync to the graph:
+
+```bash
+ginko push research
+```
+
+This uploads the Research document to the graph for semantic search and cross-referencing with other project knowledge.
+
+---
+
+**Remember:** The goal is structured understanding, not a build plan. A research session that concludes "the problem isn't what we thought" is a successful outcome. Resist the urge to make it productive in the conventional sense.

package/dist/templates/sprint-template.md

@@ -75,8 +75,30 @@ For each task, generate the full structure:
 - [ ] {Specific, testable criterion 1}
 - [ ] {Specific, testable criterion 2}
 - [ ] {Tests pass}
+
+**Verification:**
+- [ ] {Concrete check derived from AC — specify method: endpoint call, browser nav, or CLI command}
+- [ ] {For API tasks: Deploy → call [endpoint] → confirm [expected response]}
+- [ ] {For UI tasks: Deploy → navigate to [page] → screenshot → confirm [element] visible}
+- [ ] {For CLI tasks: Run [command] → confirm [expected output]}
 ```
 
+### Verification Step Generation (EPIC-025)
+
+For each acceptance criterion, generate a corresponding **verification step** that specifies the concrete check method:
+
+| Task Type | Verification Pattern |
+|-----------|---------------------|
+| **API** | Deploy → `curl [endpoint]` → confirm response shape/status |
+| **UI** | Deploy → navigate to [page] via `/browse` → screenshot → confirm [element] visible → check console |
+| **CLI** | Run `[command]` → confirm [expected output] |
+
+**Rules:**
+- Every AC gets a verification step — no "confirm it works" generics
+- UI tasks MUST include browser console check (catches hydration errors, missing props)
+- Verification steps are editable — present them for human review before finalizing
+- If task type is ambiguous, include both API and browser verification
+
 ### Confidence Scoring (Critical)
 
 Be honest about your confidence in each task:
@@ -156,6 +178,36 @@ Example: `docs/sprints/SPRINT-2026-02-adhoc_260205_s01-dashboard-fixes.md`
 
 ---
 
+## Task Dependencies (EPIC-025)
+
+{After defining all tasks, derive dependencies from task descriptions and file overlaps.
+Render as ASCII tree. Mark independent tasks explicitly.}
+
+```
+t01 ─── t02 (needs t01's types)
+  └──── t03 (needs t01's output)
+t04 ──── (independent)
+t05 ──── (independent)
+```
+
+{Omit this section if all tasks are independent.}
+
+---
+
+## Integration Warnings (EPIC-025)
+
+{Auto-generate from task Scope/Files sections. Identify files referenced by 2+ tasks.}
+
+```
+⚠️ t01, t03 both modify `component.tsx` — t03 depends on t01's changes
+⚠️ t02, t04 both modify `api-route.ts` — review recommended
+✅ t05, t06 both modify `utils.ts` — independent changes, safe to parallelize
+```
+
+{Omit this section if no file overlaps detected.}
+
+---
+
 ## Related Documents
 
 - **Epic**: {Epic name or "Ad-Hoc Work"}

package/dist/utils/tier.d.ts

@@ -0,0 +1,40 @@
+/**
+ * @fileType: utility
+ * @status: current
+ * @updated: 2026-03-17
+ * @tags: [tier, subscription, billing, cli, epic-026]
+ * @related: [api-client.ts, commands/start.ts, commands/status.ts]
+ * @priority: high
+ * @complexity: low
+ * @dependencies: [chalk]
+ *
+ * CLI tier resolution and caching (EPIC-026)
+ * Fetches user tier from dashboard API, caches locally with TTL.
+ */
+export interface TierInfo {
+    tier: 'free' | 'pro' | 'suspended';
+    isPro: boolean;
+    isTrial: boolean;
+    trialDaysLeft: number | null;
+    isSuspended: boolean;
+    subscriptionEndsAt: string | null;
+}
+/**
+ * Get the user's subscription tier.
+ * Fetches from API, falls back to cache if offline.
+ */
+export declare function getTier(): Promise<TierInfo | null>;
+/**
+ * Format tier for display in CLI output.
+ */
+export declare function formatTierDisplay(tier: TierInfo): string;
+/**
+ * Show trial expiry warning if trial ends within 3 days.
+ * Call this during `ginko start` to surface urgency.
+ */
+export declare function showTrialWarning(tier: TierInfo): void;
+/**
+ * Show upgrade prompt for free/suspended users.
+ */
+export declare function showUpgradePrompt(): Promise<void>;
+//# sourceMappingURL=tier.d.ts.map

package/dist/utils/tier.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tier.d.ts","sourceRoot":"","sources":["../../src/utils/tier.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AASH,MAAM,WAAW,QAAQ;IACvB,IAAI,EAAE,MAAM,GAAG,KAAK,GAAG,WAAW,CAAC;IACnC,KAAK,EAAE,OAAO,CAAC;IACf,OAAO,EAAE,OAAO,CAAC;IACjB,aAAa,EAAE,MAAM,GAAG,IAAI,CAAC;IAC7B,WAAW,EAAE,OAAO,CAAC;IACrB,kBAAkB,EAAE,MAAM,GAAG,IAAI,CAAC;CACnC;AAUD;;;GAGG;AACH,wBAAsB,OAAO,IAAI,OAAO,CAAC,QAAQ,GAAG,IAAI,CAAC,CA6CxD;AAED;;GAEG;AACH,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,QAAQ,GAAG,MAAM,CAWxD;AAED;;;GAGG;AACH,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,QAAQ,GAAG,IAAI,CAUrD;AAED;;GAEG;AACH,wBAAsB,iBAAiB,IAAI,OAAO,CAAC,IAAI,CAAC,CAavD"}

package/dist/utils/tier.js

@@ -0,0 +1,146 @@
+/**
+ * @fileType: utility
+ * @status: current
+ * @updated: 2026-03-17
+ * @tags: [tier, subscription, billing, cli, epic-026]
+ * @related: [api-client.ts, commands/start.ts, commands/status.ts]
+ * @priority: high
+ * @complexity: low
+ * @dependencies: [chalk]
+ *
+ * CLI tier resolution and caching (EPIC-026)
+ * Fetches user tier from dashboard API, caches locally with TTL.
+ */
+import chalk from 'chalk';
+import { api } from './api-client.js';
+import { isAuthenticated } from './auth-storage.js';
+import * as fs from 'fs';
+import * as path from 'path';
+import * as os from 'os';
+const CACHE_TTL_MS = 24 * 60 * 60 * 1000; // 24 hours
+const CACHE_FILE = path.join(os.homedir(), '.ginko', 'tier-cache.json');
+/**
+ * Get the user's subscription tier.
+ * Fetches from API, falls back to cache if offline.
+ */
+export async function getTier() {
+    if (!await isAuthenticated()) {
+        return null;
+    }
+    // Try cache first if fresh
+    const cached = readCache();
+    if (cached) {
+        const age = Date.now() - new Date(cached.fetchedAt).getTime();
+        if (age < CACHE_TTL_MS) {
+            return cached.data;
+        }
+    }
+    // Fetch from API
+    try {
+        const response = await api.get('/api/v1/user/tier');
+        if (response.data) {
+            const tierInfo = {
+                tier: response.data.tier,
+                isPro: response.data.isPro,
+                isTrial: response.data.isTrial,
+                trialDaysLeft: response.data.trialDaysLeft,
+                isSuspended: response.data.isSuspended,
+                subscriptionEndsAt: response.data.subscriptionEndsAt,
+            };
+            writeCache(tierInfo);
+            return tierInfo;
+        }
+    }
+    catch {
+        // API unreachable — fall back to cache (even if stale)
+        if (cached) {
+            return cached.data;
+        }
+    }
+    // No cache, no API — default to free
+    return {
+        tier: 'free',
+        isPro: false,
+        isTrial: false,
+        trialDaysLeft: null,
+        isSuspended: false,
+        subscriptionEndsAt: null,
+    };
+}
+/**
+ * Format tier for display in CLI output.
+ */
+export function formatTierDisplay(tier) {
+    if (tier.isTrial) {
+        return chalk.cyan(`Pro Trial (${tier.trialDaysLeft} day${tier.trialDaysLeft === 1 ? '' : 's'} left)`);
+    }
+    if (tier.isPro) {
+        return chalk.green('Pro');
+    }
+    if (tier.isSuspended) {
+        return chalk.yellow('Suspended');
+    }
+    return chalk.dim('Free');
+}
+/**
+ * Show trial expiry warning if trial ends within 3 days.
+ * Call this during `ginko start` to surface urgency.
+ */
+export function showTrialWarning(tier) {
+    if (!tier.isTrial || tier.trialDaysLeft === null)
+        return;
+    if (tier.trialDaysLeft <= 0) {
+        console.log(chalk.yellow('\n  ⏰ Your Pro trial has ended. Upgrade to keep Pro features.'));
+        console.log(chalk.dim('     Upgrade: https://app.ginkoai.com/pricing'));
+    }
+    else if (tier.trialDaysLeft <= 3) {
+        console.log(chalk.yellow(`\n  ⏰ Pro trial ends in ${tier.trialDaysLeft} day${tier.trialDaysLeft === 1 ? '' : 's'}`));
+        console.log(chalk.dim('     Upgrade: https://app.ginkoai.com/pricing'));
+    }
+}
+/**
+ * Show upgrade prompt for free/suspended users.
+ */
+export async function showUpgradePrompt() {
+    try {
+        const response = await api.get('/api/v1/stripe/promo-status', false);
+        if (response.data?.isPromoActive && response.data.currentTier) {
+            const t = response.data.currentTier;
+            const price = `$${t.annualPrice / 100}/yr ($${t.monthlyEquivalent / 100}/mo)`;
+            const seats = `${t.seatsDisplayed} of ${t.seatLimit} ${t.label.toLowerCase()} seats claimed`;
+            console.log(chalk.yellow(`\n  ⭐ ${t.label} adopter pricing: ${price} — ${seats}`));
+            console.log(chalk.dim('     Upgrade: https://app.ginkoai.com/pricing'));
+        }
+    }
+    catch {
+        // Silently fail — promo display is non-critical
+    }
+}
+function readCache() {
+    try {
+        if (fs.existsSync(CACHE_FILE)) {
+            const data = fs.readFileSync(CACHE_FILE, 'utf-8');
+            return JSON.parse(data);
+        }
+    }
+    catch {
+        // Corrupted cache
+    }
+    return null;
+}
+function writeCache(data) {
+    try {
+        const dir = path.dirname(CACHE_FILE);
+        if (!fs.existsSync(dir)) {
+            fs.mkdirSync(dir, { recursive: true });
+        }
+        fs.writeFileSync(CACHE_FILE, JSON.stringify({
+            data,
+            fetchedAt: new Date().toISOString(),
+        }), 'utf-8');
+    }
+    catch {
+        // Non-critical
+    }
+}
+//# sourceMappingURL=tier.js.map

package/dist/utils/tier.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tier.js","sourceRoot":"","sources":["../../src/utils/tier.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ginkoai/cli",
-  "version": "2.5.1",
+  "version": "2.6.0",
   "description": "Git-native session management and cloud context for AI-mediated development. AI Collaboration for Vibe Tribes.",
   "main": "dist/index.js",
   "bin": {