openalmanac 0.2.34 → 0.2.36

package/dist/auth.d.ts

@@ -16,7 +16,7 @@ export declare function getAuthStatus(): Promise<AuthStatus>;
 export declare function buildAuthHeaders(): Record<string, string>;
 export declare function request(method: string, path: string, options?: {
     auth?: boolean;
-    params?: Record<string, string | number>;
+    params?: Record<string, string | number | boolean>;
     json?: unknown;
     body?: string;
     contentType?: string;

package/dist/cli.js

@@ -1,7 +1,7 @@
 #!/usr/bin/env node
 import { createServer } from "./server.js";
 import { runLogin, runLogout } from "./login.js";
-import { runSetup } from "./setup.js";
+import { runSetup, runRedditSetup } from "./setup.js";
 const command = process.argv[2];
 if (command === "setup") {
     runSetup().catch((e) => {
@@ -9,6 +9,12 @@ if (command === "setup") {
         process.exit(1);
     });
 }
+else if (command === "reddit") {
+    runRedditSetup().catch((e) => {
+        console.error(e instanceof Error ? e.message : e);
+        process.exit(1);
+    });
+}
 else if (command === "login") {
     runLogin().catch((e) => {
         console.error(e instanceof Error ? e.message : e);

package/dist/server.js

@@ -47,7 +47,7 @@ export function createServer() {
             "",
             "Your answers should feel like living knowledge — with linked entities and images, not plain text walls.",
             "",
-            "**Entity links:** Before writing your response, call `search_articles` with the key entity names you plan to mention (e.g. `queries: [\"Theravada Buddhism\", \"Thailand\", \"Angkor Wat\"]`). This returns which articles/stubs exist and their slugs. Then use `[[slug|Display Text]]` wikilink syntax in your response for entities that exist. These render as orange links the user can click to navigate. Only link entities that actually exist in the knowledge base — don't guess slugs.",
+            "**Entity links:** Before writing your response, call `search_articles` with the key entity names you plan to mention (e.g. `queries: [\"Theravada Buddhism\", \"Thailand\", \"Angkor Wat\"]`). This returns which articles/stubs exist and their slugs. Then use `[[slug|Display Text]]` wikilink syntax in your response. Published articles preserve wikilinks in storage; dead links auto-create stub articles on publish (community wikis) so round-trip editing stays faithful.",
             "",
             "**Images:** Use `search_images` to find 1-2 relevant images for your response. Include them using the figure syntax: `![Descriptive caption](image_url \"position\")` where position is `right`, `left`, or `center`. Always write a descriptive caption. Use `view_images` to verify candidates before including them.",
             "",
@@ -78,7 +78,7 @@ export function createServer() {
             "",
             'Example: User says "I\'m interested in UX." Don\'t say "Would you like to focus on history, applications, or companies?" Instead, research and say: "So UX was coined by Don Norman at Apple in 1993, but the practice goes back to Henry Dreyfuss in the 1950s designing telephone handsets by measuring thousands of human bodies. There\'s also the dark patterns side — Ryanair\'s checkout flow got studied in academic papers as a case study in hostile design. And there\'s the curb cut effect — features designed for disabled users that end up benefiting everyone. What pulls you?"',
             "",
-            "**User has no topic** → Talk to them. What are they into — a movie they just watched, a hobby, something from work, a place they visited, a news story that caught their eye? Once you have a thread, research it and come back with real information. You can also use requested_articles to find stubs with high demand (many articles link to them), research a few, and share what you find.",
+            "**User has no topic** → Talk to them. What are they into — a movie they just watched, a hobby, something from work, a place they visited, a news story that caught their eye? Once you have a thread, research it and come back with real information. You can also use `list_articles` with `sort: \"most_referenced\"` and `stubs_only: true` on a community wiki to find high-demand stubs.",
             "",
             "**User wants to edit an existing article** → Download it and read it. Look for what's *interesting but underdeveloped* — a one-sentence mention of a controversy probably has a whole story behind it. Share what you find and propose going deeper.",
             "",
@@ -103,7 +103,7 @@ export function createServer() {
             "",
             "3. **Read the writing guidelines** — Fetch https://www.openalmanac.org/writing-guidelines.md and https://www.openalmanac.org/ai-patterns-to-avoid.md before writing a single word.",
             "",
-            "4. **Scaffold** — Use `new` to create the article file. List ALL sources you've gathered in the frontmatter before writing any body text. Don't discard sources — if you read it during research and it's relevant, include it.",
+            "4. **Scaffold** — Use `new` with one or more `{ title, slug?, topics? }` entries. Provide `slug` when you know the canonical ID; otherwise it is auto-derived from the title. For community wikis pass `community_slug`. List ALL sources you've gathered in the frontmatter before writing any body text. Don't discard sources — if you read it during research and it's relevant, include it.",
             "",
             "5. **Write a pure text draft** — This whole process (writing, review, fact-check, images, linking) takes a few minutes. Let the user know in a fun way that they can step away — and that once it's ready, you're happy to discuss any edits or polishing.",
             "",
@@ -114,11 +114,11 @@ export function createServer() {
             "   - **Review agent** → tell it to read https://www.openalmanac.org/review-guidelines.md and review the draft at `~/.openalmanac/articles/{slug}.md`",
             "   - **Fact-check agent** → tell it to read https://www.openalmanac.org/fact-checking-guidelines.md and fact-check the draft at `~/.openalmanac/articles/{slug}.md`",
             "   - **Image agent** → tell it to read https://www.openalmanac.org/image-guidelines.md and find images for the draft at `~/.openalmanac/articles/{slug}.md`",
-            "   - **Linking agent** → tell it to read https://www.openalmanac.org/linking-guidelines.md and create stubs/wikilinks for the draft at `~/.openalmanac/articles/{slug}.md`",
+            "   - **Linking agent** → tell it to read https://www.openalmanac.org/linking-guidelines.md and add wikilinks for the draft at `~/.openalmanac/articles/{slug}.md` (dead links become stubs on publish — no manual `create_stubs` step)",
             "",
             "7. **Integrate** — Present the review and fact-check feedback to the user. Then fix everything in one pass: review issues, fact-check corrections, add images, add wikilinks.",
             "",
-            "8. **Publish** — Validate and publish. Share the exact URL from the publish response (it includes a celebration page). Then search_communities for relevant communities and suggest linking.",
+            "8. **Publish** — Validate and publish (`publish` with `slugs` or `community_slug` to batch). Put per-article change notes in frontmatter as `edit_summary` (maps to the API). Share the exact URL from the publish response when single-article. For community wikis, use `list_articles` to verify coverage.",
             "",
             "Why this order: the draft must be finished before subagents run. The linking agent needs to see what entities are actually in the text. The image agent needs to match images to specific content. The review agent needs the complete article. Everything reads the draft.",
             "",
@@ -126,9 +126,9 @@ export function createServer() {
             "",
             "Reading and searching articles is open. Writing requires an API key (from login). Login creates a personal API key linked to your user account, so contributions are attributed to you.",
             "",
-            "Core flow: login (once) → search_articles (check if exists) → search_web + read_webpage (research) → new (scaffold) or download (existing) → edit ~/.openalmanac/articles/{slug}.md → publish (validate & publish).",
+            "Core flow: login (once) → search_articles (check if exists) → search_web + read_webpage (research) → `new` (batch scaffold, auto slugs) or `download` (batch) → edit files under ~/.openalmanac/articles/ → `publish` (slugs or community_slug for folder batch).",
             "",
-            "After publishing, share the celebration URL. Then call search_communities, suggest relevant ones, and link_article if the user confirms.",
+            "After publishing, share the celebration URL when applicable. Community-owned articles are created under a community path — use `list_articles` to browse a community wiki.",
             "",
             "When working with tool results, write down any important information you might need later, as the original tool result may be cleared.",
         ].join("\n"),

package/dist/setup.d.ts

@@ -1 +1,2 @@
 export declare function runSetup(): Promise<void>;
+export declare function runRedditSetup(): Promise<void>;

package/dist/setup.js

@@ -1,37 +1,37 @@
-import { readFileSync, writeFileSync, mkdirSync, existsSync } from "fs";
+import { readFileSync, writeFileSync, mkdirSync, existsSync, cpSync } from "fs";
 import { homedir } from "os";
-import { join } from "path";
+import { join, dirname } from "path";
+import { fileURLToPath } from "url";
 import { performLogin } from "./login-core.js";
 import { getAuthStatus } from "./auth.js";
 const TOOL_GROUPS = [
     {
         name: "Search & Read",
-        description: "search articles, download, view status",
+        description: "search, read, download, and browse community wiki articles",
         tools: [
             "mcp__almanac__search_articles",
             "mcp__almanac__download",
             "mcp__almanac__read",
-            "mcp__almanac__status",
-            "mcp__almanac__requested_articles",
+            "mcp__almanac__list_articles",
         ],
     },
     {
         name: "Research",
-        description: "web search, read pages, find images",
+        description: "web search, read pages, register sources, find images",
         tools: [
             "mcp__almanac__search_web",
             "mcp__almanac__read_webpage",
+            "mcp__almanac__register_sources",
             "mcp__almanac__search_images",
             "mcp__almanac__view_images",
         ],
     },
     {
         name: "Write & Publish",
-        description: "create articles, publish edits, stubs",
+        description: "create article drafts and publish edits",
         tools: [
             "mcp__almanac__new",
             "mcp__almanac__publish",
-            "mcp__almanac__create_stubs",
         ],
     },
     {
@@ -41,12 +41,11 @@ const TOOL_GROUPS = [
     },
     {
         name: "Community",
-        description: "communities, posts, article linking",
+        description: "communities and posts",
         tools: [
             "mcp__almanac__search_communities",
             "mcp__almanac__create_community",
             "mcp__almanac__create_post",
-            "mcp__almanac__link_article",
         ],
     },
     {
@@ -562,3 +561,109 @@ export async function runSetup() {
     printResult(agent, loginResult, mcpChanged, count);
     process.exit(0);
 }
+/* ── Skill installation ────────────────────────────────────────── */
+function getPackageSkillsDir() {
+    const thisFile = fileURLToPath(import.meta.url);
+    // dist/setup.js → package root → skills/
+    return join(dirname(thisFile), "..", "skills");
+}
+function installSkill(skillName) {
+    const src = join(getPackageSkillsDir(), skillName);
+    if (!existsSync(src)) {
+        throw new Error(`Skill "${skillName}" not found in package at ${src}`);
+    }
+    const dest = join(homedir(), ".claude", "skills", skillName);
+    // Always overwrite to ensure latest version
+    mkdirSync(dirname(dest), { recursive: true });
+    cpSync(src, dest, { recursive: true, force: true });
+    return true;
+}
+/* ── Reddit-specific tool groups ───────────────────────────────── */
+const REDDIT_EXTRA_TOOLS = [
+    "Bash(node *)",
+    "Bash(curl *)",
+];
+/* ── Reddit setup banner ───────────────────────────────────────── */
+function printRedditBanner() {
+    process.stdout.write("\n");
+    for (let i = 0; i < LOGO_LINES.length; i++) {
+        process.stdout.write(`${GRADIENT[i]}${LOGO_LINES[i]}${RST}\n`);
+    }
+    process.stdout.write(`\n${DIM}  Turn any subreddit into a wiki${RST}\n`);
+}
+/* ── Reddit result screen ──────────────────────────────────────── */
+function printRedditResult(agent, loginResult, mcpChanged, toolCount) {
+    process.stdout.write("\x1b[2J\x1b[H");
+    printRedditBanner();
+    printBadge();
+    w("");
+    stepDone(`Agent \u2192 ${WHITE_BOLD}${agent}${RST}`);
+    w(BAR);
+    stepDone(`MCP server ${mcpChanged ? "configured" : `${DIM}already configured${RST}`}`);
+    w(BAR);
+    stepDone(`${BLUE}${toolCount}${RST} tool${toolCount !== 1 ? "s" : ""} allowed`);
+    w(BAR);
+    stepDone(loginLabel(loginResult));
+    w(BAR);
+    stepDone(`${BLUE}/reddit-wiki${RST} skill installed`);
+    w(BAR);
+    stepDone(`${BLUE}Setup complete${RST}`);
+    w("");
+    // Next steps box
+    const innerW = 62;
+    const row = (content) => {
+        const padding = Math.max(0, innerW - vis(content));
+        return `  ${BLUE_DIM}\u2502${RST}${content}${" ".repeat(padding)}${BLUE_DIM}\u2502${RST}`;
+    };
+    const empty = row("");
+    w(`  ${BLUE_DIM}\u256d${"─".repeat(innerW)}\u256e${RST}`);
+    w(empty);
+    w(row(`  ${WHITE_BOLD}Next steps${RST}`));
+    w(empty);
+    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(`  ${BLUE_DIM}\u2570${"─".repeat(innerW)}\u256f${RST}`);
+    w("");
+}
+/* ── Reddit entry point ────────────────────────────────────────── */
+export async function runRedditSetup() {
+    const skipTui = process.argv.includes("--yes") || process.argv.includes("-y");
+    const interactive = process.stdin.isTTY && !skipTui;
+    let agent = "Claude Code";
+    if (interactive) {
+        agent = await runAgentSelect();
+    }
+    const mcpChanged = configureMcp();
+    let tools;
+    if (interactive) {
+        tools = await runToolSelect(agent, mcpChanged);
+    }
+    else {
+        tools = TOOL_GROUPS.flatMap((g) => g.tools);
+    }
+    // Add reddit-specific tool permissions
+    tools = [...tools, ...REDDIT_EXTRA_TOOLS];
+    const count = configurePermissions(tools);
+    // Login step
+    let loginResult;
+    if (interactive) {
+        loginResult = await runLoginStep(agent, mcpChanged, count);
+    }
+    else {
+        try {
+            const result = await performLogin();
+            loginResult =
+                result.status === "already_logged_in"
+                    ? { status: "already", name: result.name }
+                    : { status: "done" };
+        }
+        catch {
+            loginResult = { status: "skipped" };
+        }
+    }
+    // Install the reddit-wiki skill
+    installSkill("reddit-wiki");
+    printRedditResult(agent, loginResult, mcpChanged, count);
+    process.exit(0);
+}