feat: enhance AI client with local API key configuration, add sharing options for project updates, and implement shipping block logic in task management

Author: Bharath-code

packages/cli/src/ai/client.ts

@@ -1,8 +1,10 @@
 import { createAnthropic } from "@ai-sdk/anthropic";
 import { streamObject } from "ai";
 import { type ZodSchema } from "zod";
-import { readConfig } from "../storage/local.js";
+import * as p from "@clack/prompts";
+import { readConfig, writeConfig } from "../storage/local.js";
 import { getCachedResult, setCachedResult } from "../storage/cache.js";
+import { colors } from "../ui/theme.js";
 
 interface ResolvedAuth {
   anthropicKey: string | null;
@@ -12,7 +14,7 @@ interface ResolvedAuth {
 function resolveAuth(): ResolvedAuth {
   const config = readConfig();
   return {
-    anthropicKey: process.env.ANTHROPIC_API_KEY || null,
+    anthropicKey: process.env.ANTHROPIC_API_KEY || config.anthropicKey || null,
     token: config.auth?.apiKey || null,
   };
 }
@@ -110,6 +112,44 @@ export async function generateStructured<T extends object>(options: {
       throw new Error("Your session has expired. Please run `loopkit auth` to log in again.");
     }
 
+    if (res.status === 402 || res.status === 403) {
+      console.log(`\n${colors.warning("⚠️  Hosted AI requires a Solo/Pro subscription.")}`);
+      console.log(colors.muted("You can upgrade your plan or Bring Your Own Key (BYOK) for free.\n"));
+
+      const useByok = await p.confirm({
+        message: "Would you like to configure your local Anthropic API Key?",
+        active: "Yes, enter key",
+        inactive: "No, cancel",
+      });
+
+      if (!p.isCancel(useByok) && useByok) {
+        const apiKey = await p.text({
+          message: "Enter your Anthropic API Key (starts with sk-ant-):",
+          placeholder: "sk-ant-...",
+          validate: (val) => {
+            if (!val.startsWith("sk-ant-")) {
+              return "Invalid key format. Key must start with 'sk-ant-'.";
+            }
+            if (val.length < 20) {
+              return "API key seems too short.";
+            }
+            return undefined;
+          },
+        });
+
+        if (!p.isCancel(apiKey) && apiKey) {
+          const config = readConfig();
+          config.anthropicKey = apiKey;
+          writeConfig(config);
+          console.log(colors.success("API key saved securely. Retrying request...\n"));
+
+          return generateStructured(options);
+        }
+      }
+      
+      throw new Error("Hosted AI is disabled on the free tier. Please upgrade or provide a local API key.");
+    }
+
     const data = await res.json();
     if (!res.ok) {
       throw new Error(data.error || "Failed to generate AI response from LoopKit servers.");

packages/cli/src/commands/celebrate.ts

@@ -12,7 +12,7 @@ import {
   readPulseResponses,
 } from "../storage/local.js";
 import { computeLoopKitScore } from "../analytics/score.js";
-import { buildProofCard, buildTweetLine, copyToClipboard } from "../ui/proof-card.js";
+import { buildProofCard, buildTweetLine, copyToClipboard, buildTwitterIntentUrl, openUrl } from "../ui/proof-card.js";
 import { colors, header, box, pass, info } from "../ui/theme.js";
 import { getConvexProjectId } from "../storage/sync.js";
 
@@ -240,12 +240,27 @@ export async function celebrateCommand(
   console.log(header("Share"));
   console.log(colors.dim("  Copy this to share your progress:"));
   console.log(box(shareText));
-  console.log(colors.dim(`  Tweet: ${tweetLine}`));
 
-  // Auto-copy to clipboard on macOS
-  const copied = await copyToClipboard(tweetLine);
-  if (copied) {
-    console.log(pass("Tweet line copied to clipboard — paste and share!"));
+  const shareAction = await p.select({
+    message: "Share this week's win:",
+    options: [
+      { value: "twitter", label: "[t]weet on X — open twitter.com/intent/tweet" },
+      { value: "copy",    label: "[c]opy tweet line to clipboard" },
+      { value: "skip",   label: "[s]kip" },
+    ],
+  });
+
+  if (!p.isCancel(shareAction)) {
+    if (shareAction === "twitter") {
+      const copied = await copyToClipboard(tweetLine);
+      const twitterUrl = buildTwitterIntentUrl(tweetLine);
+      await openUrl(twitterUrl);
+      console.log(pass("Opened X/Twitter in browser!"));
+      if (copied) console.log(colors.dim("  (Also copied to clipboard as fallback.)"));
+    } else if (shareAction === "copy") {
+      const copied = await copyToClipboard(tweetLine);
+      if (copied) console.log(pass("Tweet line copied to clipboard — paste and share!"));
+    }
   }
 
   // ─── Share to public wins feed (if --share flag) ─────────────────

packages/cli/src/commands/loop.ts

@@ -28,7 +28,7 @@ import { predictSuccess, renderPrediction } from "../analytics/predictor.js";
 import { detectPatterns } from "../analytics/patterns.js";
 import { getPriorityMoment, recordMomentShown } from "../analytics/coach.js";
 import { computeLoopKitScore, renderLoopKitScore, readLoopKitScoreFromLog } from "../analytics/score.js";
-import { buildProofCard, buildTweetLine, copyToClipboard } from "../ui/proof-card.js";
+import { buildProofCard, buildTweetLine, copyToClipboard, buildTwitterIntentUrl, openUrl } from "../ui/proof-card.js";
 import { colors, header, box, pass, warn, info, nextStep, scoreBar, shortcutsHint, emptyState, patternCard, coachingCard } from "../ui/theme.js";
 
 interface LoopProof {
@@ -495,13 +495,27 @@ export async function loopCommand(options?: { revenue?: string; async?: boolean
     );
 
     const postAction = await p.select({
-      message: "Post:",
+      message: "Share this post:",
       options: [
-        { value: "use", label: "[u]se as-is" },
-        { value: "skip", label: "[s]kip" },
+        { value: "twitter", label: "[t]weet on X  — open twitter.com/intent/tweet" },
+        { value: "copy",    label: "[c]opy to clipboard" },
+        { value: "skip",   label: "[s]kip" },
       ],
     });
 
+    if (!p.isCancel(postAction)) {
+      if (postAction === "twitter") {
+        const bipCopied = await copyToClipboard(synthesis.bipPost);
+        const twitterUrl = buildTwitterIntentUrl(synthesis.bipPost);
+        await openUrl(twitterUrl);
+        console.log(pass("Opened X/Twitter in browser."));
+        if (bipCopied) console.log(colors.dim("  (Also copied to clipboard as fallback.)"));
+      } else if (postAction === "copy") {
+        const bipCopied = await copyToClipboard(synthesis.bipPost);
+        if (bipCopied) console.log(pass("BIP post copied to clipboard."));
+      }
+    }
+
     // ─── Proof Card (GF-2) ───────────────────────────────────
     const latestMRR = getLatestMRR();
     const proofCardData = {
@@ -523,11 +537,24 @@ export async function loopCommand(options?: { revenue?: string; async?: boolean
 
     console.log(header("Proof Card"));
     console.log(box(proofCardText, `Week ${weekNum} Card`));
-    console.log(colors.dim(`  Tweet: ${tweetLine}`));
 
-    const copied = await copyToClipboard(tweetLine);
-    if (copied) {
-      console.log(pass("Tweet line copied to clipboard — paste and share!"));
+    const cardCopied = await copyToClipboard(tweetLine);
+    if (cardCopied) {
+      console.log(pass("Tweet line copied to clipboard."));
+    }
+
+    const cardShareAction = await p.select({
+      message: "Share proof card:",
+      options: [
+        { value: "twitter", label: "[t]weet on X — open twitter.com/intent/tweet" },
+        { value: "skip",   label: "[s]kip" },
+      ],
+    });
+
+    if (!p.isCancel(cardShareAction) && cardShareAction === "twitter") {
+      const twitterUrl = buildTwitterIntentUrl(tweetLine);
+      await openUrl(twitterUrl);
+      console.log(pass("Opened X/Twitter in browser!"));
     }
 
 

packages/cli/src/commands/track.ts

@@ -18,6 +18,8 @@ import {
   saveStandup,
   readStandup,
   getStandupStreak,
+  getLastShipDate,
+  getProjectCreationDate,
 } from "../storage/local.js";
 import { computeBenchmarks, renderBenchmarks } from "../analytics/benchmarks.js";
 import { getSnoozeWarning } from "../analytics/oracle.js";
@@ -59,9 +61,9 @@ export async function trackCommand(options?: {
   // ─── --add: Quick task add ────────────────────────────────────
   if (options?.add) {
     if (typeof options.add === "string") {
-      addTask(slug, options.add);
+      await addTask(slug, options.add);
     } else {
-      addTasksViaEditor(slug);
+      await addTasksViaEditor(slug);
     }
     return;
   }
@@ -118,6 +120,16 @@ export async function trackCommand(options?: {
 
   // ─── Board View ───────────────────────────────────────────────
   console.log(shortcutsHint());
+
+  const lastShip = getLastShipDate(slug);
+  const refDate = lastShip || getProjectCreationDate(slug);
+  const now = new Date();
+  const diffTime = now.getTime() - refDate.getTime();
+  const diffDays = Math.floor(diffTime / (1000 * 60 * 60 * 24));
+  if (diffDays > 14) {
+    console.log(colors.danger(`  ⚠️  SHIPPING BLOCK ACTIVE: You haven't shipped in ${diffDays} days! Task addition is locked unless overridden.\n`));
+  }
+
   console.log(header("This Week"));
 
   if (visibleOpen.length === 0 && done.length === 0 && snoozedActive.length === 0) {
@@ -390,9 +402,53 @@ function parseTasks(content: string): ParsedTask[] {
   return tasks;
 }
 
+async function handleShippingBlock(slug: string): Promise<boolean> {
+  const lastShip = getLastShipDate(slug);
+  const refDate = lastShip || getProjectCreationDate(slug);
+  const now = new Date();
+  
+  const diffTime = now.getTime() - refDate.getTime();
+  const diffDays = Math.floor(diffTime / (1000 * 60 * 60 * 24));
+  
+  if (diffDays > 14) {
+    console.log(colors.danger(`\n⚠️  SHIPPING BLOCK: You haven't shipped in ${diffDays} days!`));
+    console.log(colors.muted("To maintain momentum, you should ship at least once every 14 days.\n"));
+    
+    const override = await p.confirm({
+      message: "Do you want to override this block and add the task anyway?",
+      active: "Yes, override",
+      inactive: "No, cancel",
+    });
+    
+    if (p.isCancel(override) || !override) {
+      console.log(colors.warning("Task addition canceled. Run `loopkit ship` first."));
+      return false;
+    }
+    
+    const reason = await p.text({
+      message: "Please enter a reason for overriding this shipping block:",
+      placeholder: "e.g., waiting on third-party API approval",
+      validate: (value) => (value.trim().length < 5 ? "Reason must be at least 5 characters." : undefined),
+    });
+    
+    if (p.isCancel(reason) || !reason) {
+      console.log(colors.warning("Task addition canceled. Reason required."));
+      return false;
+    }
+    
+    console.log(colors.success(`Override registered. Reason: "${reason}"`));
+  }
+  return true;
+}
+
 // ─── Task Operations ─────────────────────────────────────────────
 
-function addTask(slug: string, title: string): void {
+async function addTask(slug: string, title: string, skipBlockCheck = false): Promise<void> {
+  if (!skipBlockCheck) {
+    const allowed = await handleShippingBlock(slug);
+    if (!allowed) return;
+  }
+
   let content = readTasksFile(slug);
   if (!content) {
     createTasksScaffold(slug, slug);
@@ -424,7 +480,10 @@ function addTask(slug: string, title: string): void {
   console.log(pass(`Added #${newId}: ${title}`));
 }
 
-function addTasksViaEditor(slug: string): void {
+async function addTasksViaEditor(slug: string): Promise<void> {
+  const allowed = await handleShippingBlock(slug);
+  if (!allowed) return;
+
   const editor =
     process.env.EDITOR ||
     process.env.VISUAL ||
@@ -460,7 +519,7 @@ function addTasksViaEditor(slug: string): void {
   }
 
   for (const title of lines) {
-    addTask(slug, title);
+    await addTask(slug, title, true);
   }
 }
 

packages/cli/src/storage/__tests__/storage.test.ts

@@ -52,6 +52,8 @@ import {
   getStandupStreak,
   getStandupPath,
   getStandupDir,
+  getLastShipDate,
+  getProjectCreationDate,
 } from "../local";
 
 const TEST_BASE = fs.mkdtempSync(path.join(os.tmpdir(), "loopkit-test-"));
@@ -766,3 +768,51 @@ describe("Token Encryption", () => {
     }
   });
 });
+
+describe("Ship and Project Creation Dates", () => {
+  beforeEach(() => {
+    cleanupTestDir();
+    fs.mkdirSync(TEST_BASE);
+    setCwdToTestDir();
+  });
+
+  afterEach(() => cleanupTestDir());
+
+  it("getLastShipDate returns null when no ship logs exist", () => {
+    ensureProjectDir("my-app");
+    expect(getLastShipDate("my-app")).toBeNull();
+  });
+
+  it("getLastShipDate returns correct date when matching ship logs exist", () => {
+    ensureProjectDir("my-app");
+    saveBrief("my-app", {
+      name: "CoolApp",
+      problem: "test",
+      icp: "test",
+      whyUnsolved: "test",
+      mvp: "test",
+    });
+
+    saveShipLog("**Product:** CoolApp\n**What shipped:** landing page", "2026-05-01");
+    saveShipLog("**Product:** CoolApp\n**What shipped:** payment gateway", "2026-05-10");
+    saveShipLog("**Product:** OtherApp\n**What shipped:** irrelevant stuff", "2026-05-15");
+
+    const lastShip = getLastShipDate("my-app");
+    expect(lastShip).not.toBeNull();
+    expect(lastShip?.toISOString().split("T")[0]).toBe("2026-05-10");
+  });
+
+  it("getProjectCreationDate falls back to file stats when brief.json is missing createdAt", () => {
+    ensureProjectDir("my-app");
+    saveBrief("my-app", {
+      name: "CoolApp",
+      problem: "test",
+      icp: "test",
+      whyUnsolved: "test",
+      mvp: "test",
+    });
+    
+    const creationDate = getProjectCreationDate("my-app");
+    expect(creationDate).toBeInstanceOf(Date);
+  });
+});