winter-super-cli 2026.5.26 → 2026.5.28

package/src/tools/web-archive.js

@@ -0,0 +1,212 @@
+/**
+ * ❄️ WEB ARCHIVE TOOL ❄️
+ * Fetch archived/cached versions of web pages from Wayback Machine,
+ * Google Cache, and local cache. Inspired by Claude Code's WebArchive.
+ */
+
+import { promises as fs } from 'fs';
+import path from 'path';
+import crypto from 'crypto';
+
+export class WebArchiveTool {
+  constructor(cacheDir) {
+    this.cacheDir = cacheDir || path.join(process.cwd(), '.winter', 'web-archive');
+    this.cacheMaxAge = 24 * 60 * 60 * 1000; // 24h default
+  }
+
+  cacheKey(url) {
+    return crypto.createHash('md5').update(url).digest('hex');
+  }
+
+  cachePath(url) {
+    return path.join(this.cacheDir, `${this.cacheKey(url)}.json`);
+  }
+
+  async readCache(url) {
+    try {
+      const cached = await fs.readFile(this.cachePath(url), 'utf8');
+      const data = JSON.parse(cached);
+      const age = Date.now() - new Date(data.cachedAt).getTime();
+      if (age < this.cacheMaxAge) {
+        return data;
+      }
+    } catch {}
+    return null;
+  }
+
+  async writeCache(url, data) {
+    try {
+      await fs.mkdir(this.cacheDir, { recursive: true });
+      await fs.writeFile(
+        this.cachePath(url),
+        JSON.stringify({ ...data, cachedAt: new Date().toISOString() }, null, 2),
+        'utf8'
+      );
+    } catch {}
+  }
+
+  async clearCache(url) {
+    if (url) {
+      try {
+        await fs.rm(this.cachePath(url), { force: true });
+        return { success: true, cleared: 1 };
+      } catch {
+        return { success: false, error: 'Cache entry not found' };
+      }
+    }
+
+    // Clear all cache
+    try {
+      await fs.rm(this.cacheDir, { recursive: true, force: true });
+      return { success: true, cleared: -1 };
+    } catch {
+      return { success: true, cleared: 0 };
+    }
+  }
+
+  async fetchFromWayback(url) {
+    try {
+      // Step 1: Check availability
+      const availUrl = `https://archive.org/wayback/available?url=${encodeURIComponent(url)}`;
+      const availResponse = await fetch(availUrl, {
+        headers: { 'User-Agent': 'WinterCLI/1.0' },
+        signal: AbortSignal.timeout(10000),
+      });
+
+      if (!availResponse.ok) return null;
+
+      const availData = await availResponse.json();
+      const closest = availData?.archived_snapshots?.closest;
+
+      if (!closest?.url) return null;
+
+      // Step 2: Fetch the archived snapshot
+      const snapshotUrl = closest.url.replace('http://', 'https://');
+      const snapshotResponse = await fetch(snapshotUrl, {
+        headers: { 'User-Agent': 'WinterCLI/1.0' },
+        signal: AbortSignal.timeout(15000),
+      });
+
+      if (!snapshotResponse.ok) return null;
+
+      const html = await snapshotResponse.text();
+
+      return {
+        source: 'wayback',
+        url: snapshotUrl,
+        timestamp: closest.timestamp,
+        status: closest.status,
+        content: html
+          .replace(/<script\b[^<]*(?:(?!<\/script>)<[^<]*)*<\/script>/gi, '')
+          .replace(/<style\b[^<]*(?:(?!<\/style>)<[^<]*)*<\/style>/gi, '')
+          .replace(/<[^>]+>/g, ' ')
+          .replace(/&amp;/g, '&')
+          .replace(/&lt;/g, '<')
+          .replace(/&gt;/g, '>')
+          .replace(/&quot;/g, '"')
+          .replace(/&#x27;/g, "'")
+          .replace(/\s+/g, ' ')
+          .trim(),
+        contentLength: html.length,
+        archivedAt: closest.timestamp
+          ? `${closest.timestamp.slice(0, 4)}-${closest.timestamp.slice(4, 6)}-${closest.timestamp.slice(6, 8)}`
+          : 'unknown',
+      };
+    } catch {
+      return null;
+    }
+  }
+
+  async fetchDirect(url) {
+    try {
+      const response = await fetch(url, {
+        headers: { 'User-Agent': 'WinterCLI/1.0' },
+        signal: AbortSignal.timeout(10000),
+      });
+
+      if (!response.ok) return null;
+
+      const html = await response.text();
+      return {
+        source: 'direct',
+        url,
+        content: html
+          .replace(/<script\b[^<]*(?:(?!<\/script>)<[^<]*)*<\/script>/gi, '')
+          .replace(/<style\b[^<]*(?:(?!<\/style>)<[^<]*)*<\/style>/gi, '')
+          .replace(/<[^>]+>/g, ' ')
+          .replace(/&amp;/g, '&')
+          .replace(/&lt;/g, '<')
+          .replace(/&gt;/g, '>')
+          .replace(/&quot;/g, '"')
+          .replace(/&#x27;/g, "'")
+          .replace(/\s+/g, ' ')
+          .trim(),
+        contentLength: html.length,
+      };
+    } catch {
+      return null;
+    }
+  }
+
+  async fetch(url, options = {}) {
+    if (!url || typeof url !== 'string' || url.trim() === '') {
+      return { success: false, error: 'url is required' };
+    }
+
+    if (options.clearCache) {
+      return await this.clearCache(options.clearCache === true ? undefined : options.clearCache);
+    }
+
+    // Normalize URL
+    const normalizedUrl = url.trim();
+
+    // Try cache first
+    if (options.cache !== false) {
+      const cached = await this.readCache(normalizedUrl);
+      if (cached) {
+        return {
+          success: true,
+          source: 'cache',
+          url: normalizedUrl,
+          content: cached.content?.substring(0, options.maxLength || 15000),
+          fullLength: cached.content?.length || 0,
+          cachedAt: cached.cachedAt,
+          originalSource: cached.source,
+        };
+      }
+    }
+
+    // Try direct fetch first (for live sites)
+    let result = null;
+    if (options.preferDirect !== false) {
+      result = await this.fetchDirect(normalizedUrl);
+    }
+
+    // Fall back to Wayback Machine
+    if (!result) {
+      result = await this.fetchFromWayback(normalizedUrl);
+    }
+
+    if (!result) {
+      return {
+        success: false,
+        error: `Unable to fetch archived content for: ${normalizedUrl}. Try WebFetch for live content.`,
+        url: normalizedUrl,
+      };
+    }
+
+    // Cache the result
+    await this.writeCache(normalizedUrl, result);
+
+    return {
+      success: true,
+      source: result.source,
+      url: normalizedUrl,
+      archivedUrl: result.url,
+      content: result.content.substring(0, options.maxLength || 15000),
+      fullLength: result.content.length,
+      archivedAt: result.archivedAt,
+      status: result.status,
+    };
+  }
+}

package/CLAUDE.md

@@ -1,118 +0,0 @@
-# ❄️ WINTER CLAUDE.md
-
-Behavioral guidelines for Winter CLI. These principles should be followed in every interaction.
-
-## The Four Principles
-
-### 1. Think Before Coding
-
-**Don't assume. Don't hide confusion. Surface tradeoffs.**
-
-Before implementing:
-- State your assumptions explicitly. If uncertain, ask.
-- If multiple interpretations exist, present them — don't pick silently.
-- If a simpler approach exists, say so. Push back when warranted.
-- If something is unclear, stop. Name what's confusing. Ask.
-
-### 2. Simplicity First
-
-**Minimum code that solves the problem. Nothing speculative.**
-
-- No features beyond what was asked
-- No abstractions for single-use code
-- No "flexibility" or "configurability" that wasn't requested
-- No error handling for impossible scenarios
-- If you write 200 lines and it could be 50, rewrite it
-
-Ask yourself: "Would a senior engineer say this is overcomplicated?" If yes, simplify.
-
-### 3. Surgical Changes
-
-**Touch only what you must. Clean up only your own mess.**
-
-When editing existing code:
-- Don't "improve" adjacent code, comments, or formatting
-- Don't refactor things that aren't broken
-- Match existing style, even if you'd do it differently
-- If you notice unrelated dead code, mention it — don't delete it
-
-When your changes create orphans:
-- Remove imports/variables/functions that YOUR changes made unused
-- Don't remove pre-existing dead code unless asked
-
-**The test:** Every changed line should trace directly to the user's request.
-
-### 4. Goal-Driven Execution
-
-**Define success criteria. Loop until verified.**
-
-Transform tasks into verifiable goals:
-- "Add validation" → "Write tests for invalid inputs, then make them pass"
-- "Fix the bug" → "Write a test that reproduces it, then make it pass"
-- "Refactor X" → "Ensure tests pass before and after"
-
-For multi-step tasks, state a brief plan:
-```
-1. [Step] → verify: [check]
-2. [Step] → verify: [check]
-3. [Step] → verify: [check]
-```
-
-## Session Management
-
-### Session Commands
-- `/session new` - Create new session
-- `/session save` - Save current session
-- `/session list` - List sessions
-- `/remember <text>` - Add to memory
-
-### Memory System
-- Working Memory - Current task context
-- Project Memory - Project-specific knowledge
-- Long-term Memory - Cross-project learnings
-
-## AI Provider Integration
-
-### Supported Providers
-- **Anthropic** - claude-3-5-sonnet, claude-3-opus (default)
-- **OpenAI** - gpt-4, gpt-4-turbo, gpt-3.5-turbo
-- **Ollama** - llama3, mistral, codellama (local)
-- **Groq** - llama-3.1-70b, mixtral-8x7b
-
-### Usage
-```bash
-winter chat "Your message" --provider anthropic
-winter call "Analyze this"  # Call all providers
-```
-
-## Skills System
-
-Built-in skills:
-- `coding` - Code analysis, generation, review
-- `design` - Design system integration
-- `debug` - Debugging assistance
-- `refactor` - Code refactoring
-- `test` - Test generation
-
-Custom skills via `winter skill create <name>`.
-
-## Design Integration
-
-Access brand design guidelines from awesome-design-md:
-```bash
-winter design search <brand>
-winter design add <brand>
-winter design preview <brand>
-```
-
-## Key Insight
-
-> "LLMs are exceptionally good at looping until they meet specific goals... Don't tell it what to do, give it success criteria and watch it go."
-
-Transform imperative instructions into declarative goals with verification loops.
-
----
-
-**These guidelines are working if:** fewer unnecessary changes in diffs, fewer rewrites due to overcomplication, and clarifying questions come before implementation rather than after mistakes.
-
-**Tradeoff:** These guidelines bias toward caution over speed. For trivial tasks, use judgment.

package/memories/readme.md

@@ -1,35 +0,0 @@
-# ❄️ Winter Memories
-
-This directory stores cross-project knowledge and learnings.
-
-## Memory Types
-
-### Long-term Memory
-Learned patterns, best practices, and project insights that persist across sessions.
-
-### Project Memory
-Project-specific knowledge including:
-- Project structure
-- Key files and their purposes
-- Common workflows
-- Team conventions
-
-## Commands
-
-- `/remember <text>` - Add a memory
-- `/memories` - Show all memories
-- `/memories search <query>` - Search memories
-- `/forget <pattern>` - Remove memories
-
-## Example Memories
-
-```
-- User prefers TypeScript over JavaScript
-- This project uses React with Vite
-- Database is PostgreSQL
-- API is REST-based
-```
-
-## Storage
-
-Memories are stored as JSON files in this directory, automatically organized by date and topic.

package/resources/local/agents.md/AGENTS.md

@@ -1,43 +0,0 @@
-# AGENTS Guidelines for This Repository
-
-This repository contains a Next.js application located in the root of this repository. When
-working on the project interactively with an agent (e.g. the Codex CLI) please follow
-the guidelines below so that the development experience – in particular Hot Module
-Replacement (HMR) – continues to work smoothly.
-
-## 1. Use the Development Server, **not** `npm run build`
-
-* **Always use `npm run dev` (or `pnpm dev`, `yarn dev`, etc.)** while iterating on the
-  application.  This starts Next.js in development mode with hot-reload enabled.
-* **Do _not_ run `npm run build` inside the agent session.**  Running the production
-  build command switches the `.next` folder to production assets which disables hot
-  reload and can leave the development server in an inconsistent state.  If a
-  production build is required, do it outside of the interactive agent workflow.
-
-## 2. Keep Dependencies in Sync
-
-If you add or update dependencies remember to:
-
-1. Update the appropriate lockfile (`package-lock.json`, `pnpm-lock.yaml`, `yarn.lock`).
-2. Re-start the development server so that Next.js picks up the changes.
-
-## 3. Coding Conventions
-
-* Prefer TypeScript (`.tsx`/`.ts`) for new components and utilities.
-* Co-locate component-specific styles in the same folder as the component when
-  practical.
-
-## 4. Useful Commands Recap
-
-| Command            | Purpose                                            |
-| ------------------ | -------------------------------------------------- |
-| `npm run dev`      | Start the Next.js dev server with HMR.             |
-| `npm run lint`     | Run ESLint checks.                                 |
-| `npm run test`     | Execute the test suite (if present).               |
-| `npm run build`    | **Production build – _do not run during agent sessions_** |
-
----
-
-Following these practices ensures that the agent-assisted development workflow stays
-fast and dependable.  When in doubt, restart the dev server rather than running the
-production build.

package/resources/local/agents.md/LICENSE

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

package/resources/local/agents.md/README.md

@@ -1,49 +0,0 @@
-# AGENTS.md
-
-![AGENTS.md logo](./public/og.png)
-
-[AGENTS.md](https://agents.md) is a simple, open format for guiding coding agents.
-
-Think of AGENTS.md as a README for agents: a dedicated, predictable place
-to provide context and instructions to help AI coding agents work on your project.
-
-Below is a minimal example of an AGENTS.md file:
-
-```markdown
-# Sample AGENTS.md file
-
-## Dev environment tips
-- Use `pnpm dlx turbo run where <project_name>` to jump to a package instead of scanning with `ls`.
-- Run `pnpm install --filter <project_name>` to add the package to your workspace so Vite, ESLint, and TypeScript can see it.
-- Use `pnpm create vite@latest <project_name> -- --template react-ts` to spin up a new React + Vite package with TypeScript checks ready.
-- Check the name field inside each package's package.json to confirm the right name—skip the top-level one.
-
-## Testing instructions
-- Find the CI plan in the .github/workflows folder.
-- Run `pnpm turbo run test --filter <project_name>` to run every check defined for that package.
-- From the package root you can just call `pnpm test`. The commit should pass all tests before you merge.
-- To focus on one step, add the Vitest pattern: `pnpm vitest run -t "<test name>"`.
-- Fix any test or type errors until the whole suite is green.
-- After moving files or changing imports, run `pnpm lint --filter <project_name>` to be sure ESLint and TypeScript rules still pass.
-- Add or update tests for the code you change, even if nobody asked.
-
-## PR instructions
-- Title format: [<project_name>] <Title>
-- Always run `pnpm lint` and `pnpm test` before committing.
-```
-
-## Website
-
-This repository also includes a basic Next.js website hosted at https://agents.md/
-that explains the project’s goals in a simple way, and featuring some examples.
-
-### Running the app locally
-1. Install dependencies:
-   ```bash
-   pnpm install
-   ```
-2. Start the development server:
-   ```bash
-   pnpm run dev
-   ```
-3. Open your browser and go to http://localhost:3000

package/resources/local/agents.md/components/AboutSection.tsx

@@ -1,37 +0,0 @@
-import Section from "@/components/Section";
-
-const AboutSection = () => (
-  <Section title="About" className="pb-0" center maxWidthClass="max-w-3xl">
-    <p className="max-w-3xl">
-      AGENTS.md emerged from collaborative efforts across the AI software
-      development ecosystem, including{" "}
-      <a href="https://openai.com/codex/" className="underline hover:no-underline" target="_blank" rel="noopener noreferrer">OpenAI Codex</a>,{" "}
-      <a href="https://ampcode.com" className="underline hover:no-underline" target="_blank" rel="noopener noreferrer">Amp</a>,{" "}
-      <a href="https://jules.google" className="underline hover:no-underline" target="_blank" rel="noopener noreferrer">Jules from Google</a>,{" "}
-      <a href="https://cursor.com" className="underline hover:no-underline" target="_blank" rel="noopener noreferrer">Cursor</a>, and{" "}
-      <a href="https://factory.ai" className="underline hover:no-underline" target="_blank" rel="noopener noreferrer">Factory</a>.
-    </p>
-
-    <p className="max-w-3xl mt-4">
-      We&rsquo;re committed to helping maintain and evolve this as an open format that benefits the entire developer community,
-      regardless of which coding agent you use.
-    </p>
-
-    <p className="max-w-3xl mt-4">
-      AGENTS.md is now stewarded by the{" "}
-      <a href="https://aaif.io" className="underline hover:no-underline">
-        Agentic AI Foundation
-      </a>{" "}
-      under the Linux Foundation.{" "}
-      <a
-        href="https://openai.com/index/agentic-ai-foundation/"
-        className="underline hover:no-underline"
-      >
-        Learn more &rarr;
-      </a>
-    </p>
-
-  </Section>
-);
-
-export default AboutSection;