openalmanac 0.2.36 → 0.2.38

package/dist/setup.js

@@ -580,8 +580,7 @@ function installSkill(skillName) {
 }
 /* ── Reddit-specific tool groups ───────────────────────────────── */
 const REDDIT_EXTRA_TOOLS = [
-    "Bash(node *)",
-    "Bash(curl *)",
+    "Bash(node */ingest.js *)",
 ];
 /* ── Reddit setup banner ───────────────────────────────────────── */
 function printRedditBanner() {
@@ -623,6 +622,8 @@ function printRedditResult(agent, loginResult, mcpChanged, toolCount) {
     w(row(`  ${BLUE}1.${RST}  Type ${WHITE_BOLD}claude${RST} to start Claude Code`));
     w(row(`  ${BLUE}2.${RST}  Run ${BLUE}/reddit-wiki r/<subreddit>${RST}`));
     w(empty);
+    w(row(`  ${DIM}Ask "how does reddit wiki work?" to learn more${RST}`));
+    w(empty);
     w(`  ${BLUE_DIM}\u2570${"─".repeat(innerW)}\u256f${RST}`);
     w("");
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "openalmanac",
-  "version": "0.2.36",
+  "version": "0.2.38",
   "description": "OpenAlmanac — pull, edit, and push articles to the open knowledge base",
   "type": "module",
   "bin": {

package/skills/reddit-wiki/SKILL.md

@@ -1,7 +1,7 @@
 ---
 name: reddit-wiki
 description: Turn any subreddit into a published wiki on Almanac
-allowed-tools: Bash(node *), Bash(curl *), mcp__almanac__search_articles, mcp__almanac__search_communities, mcp__almanac__list_articles, mcp__almanac__read, mcp__almanac__download, mcp__almanac__new, mcp__almanac__publish, mcp__almanac__search_web, mcp__almanac__read_webpage, mcp__almanac__search_images, mcp__almanac__view_images, mcp__almanac__register_sources, mcp__almanac__login, mcp__almanac__create_community, Read(~/.openalmanac/**), Write(~/.openalmanac/**), Edit(~/.openalmanac/**)
+allowed-tools: Bash(node ${CLAUDE_SKILL_DIR}/scripts/ingest.js *), mcp__almanac__search_articles, mcp__almanac__search_communities, mcp__almanac__list_articles, mcp__almanac__read, mcp__almanac__download, mcp__almanac__new, mcp__almanac__publish, mcp__almanac__search_web, mcp__almanac__read_webpage, mcp__almanac__search_images, mcp__almanac__view_images, mcp__almanac__register_sources, mcp__almanac__login, mcp__almanac__create_community, Read(~/.openalmanac/**), Write(~/.openalmanac/**), Edit(~/.openalmanac/**)
 argument-hint: r/<subreddit>
 ---
 
@@ -28,6 +28,18 @@ Two phases:
 - **API calls / community slugs**: Bare name — `subreddit=lockpicking`
 - **Accept both** as input: `r/lockpicking` or `lockpicking`
 
+## If no subreddit is given (or user asks "how does this work")
+
+If the user runs `/reddit-wiki` without arguments or asks how it works, explain briefly:
+
+- **What it does:** Takes any subreddit and builds a wiki on Almanac — real articles with citations, images, and links between them. Two phases: a foundation of 15-20 core articles, then a deep pass through the corpus finding niche topics.
+- **What Almanac is:** An open knowledge base anyone can read and write to. Think Wikipedia's depth meets Reddit's community energy.
+- **How it works:** Downloads the subreddit's history, scores posts by quality, then uses AI agents to research and write articles citing the community's own discussions.
+- **Data storage:** Everything is stored locally at `~/.openalmanac/corpus/<subreddit>/`. The user can delete it anytime after the wiki is published.
+- **Any subreddit:** They can pick any subreddit they're interested in. Some smaller or newer subreddits may not have data available — if that happens, you'll suggest alternatives or nearby subreddits that do have data.
+
+Then ask them which subreddit they want to build a wiki for.
+
 ## Step 1: Scout
 
 Extract the subreddit name from the argument (strip `r/` prefix if present). Use the bare name for all API calls and file paths. Use `r/<name>` when talking to the user.
@@ -79,8 +91,17 @@ node ${CLAUDE_SKILL_DIR}/scripts/ingest.js <subreddit> download --since <year>
 
 This saves raw JSONL to `~/.openalmanac/corpus/<subreddit>/raw/`. The raw data is kept so you can re-filter later with different quality thresholds without re-downloading.
 
+Tell the user:
+
+```
+Downloading now. Go grab a coffee ☕ — I'll have everything 
+ready when you get back.
+```
+
 While it downloads, share interesting context about the community. Use your knowledge and do a quick `search_web` if helpful. Share REAL information — facts, history, notable members, what makes this community unique. Not questions, not small talk.
 
+Also tell them where the data is being stored: `~/.openalmanac/corpus/<subreddit>/`
+
 When the download finishes, run the filter step:
 
 ```bash
@@ -113,7 +134,15 @@ This writes markdown entries to `~/.openalmanac/corpus/<subreddit>/entries/`. Ea
 
 Report the results:
 - How many entries were created
-- Where they're stored
+- Where they're stored (`~/.openalmanac/corpus/<subreddit>/entries/`)
+
+### If the subreddit has no data on Arctic Shift
+
+If the `count` command returns 0 posts, the subreddit may not be indexed. In this case:
+- Tell the user this subreddit doesn't have historical data available
+- Suggest nearby or related subreddits by searching Arctic Shift for similar names
+- Ask if they'd like to try one of those instead
+- Do NOT just fail silently — help them find something that works
 
 ## Step 3: Phase 1 — Foundation
 

package/skills/reddit-wiki/scripts/ingest.js

@@ -54,6 +54,10 @@ function parseArgs() {
   }
 
   const subreddit = args[0].replace(/^r\//, "");
+  if (!/^[a-zA-Z0-9_]+$/.test(subreddit)) {
+    console.error(`Invalid subreddit name: ${subreddit}`);
+    process.exit(1);
+  }
   const command = args[1]; // download, filter, or count
 
   const opts = {
@@ -142,7 +146,9 @@ async function* paginateSearch(subreddit, type, since, limit = 100) {
 
     const lastCreated = items[items.length - 1].created_utc;
     if (!lastCreated) break;
-    after = new Date(lastCreated * 1000).toISOString();
+    const newAfter = new Date(lastCreated * 1000).toISOString();
+    if (newAfter === after) break; // no progress — would loop forever on duplicate timestamps
+    after = newAfter;
   }
 }
 
@@ -436,7 +442,7 @@ async function runDownload(opts) {
     postCount += batch.length;
     printProgress("Posts", postCount, estPosts);
   }
-  postsStream.end();
+  await new Promise(resolve => postsStream.end(resolve));
   console.error("");
 
   // Download comments → raw/comments.jsonl
@@ -453,7 +459,7 @@ async function runDownload(opts) {
       commentCount += batch.length;
       printProgress("Comments", commentCount, estComments);
     }
-    commentsStream.end();
+    await new Promise(resolve => commentsStream.end(resolve));
     console.error("");
   }