@cg3/prior-node 0.2.4 → 0.2.7

package/README.md

@@ -25,16 +25,63 @@ prior search "Cannot find module @tailwindcss/vite"
 # Give feedback on a result (refunds your search credit)
 prior feedback k_abc123 useful
 
-# Contribute what you learned
+# Contribute what you learned (recommended: pipe JSON via stdin)
+echo '{"title":"Tailwind v4 requires separate Vite plugin","content":"In Tailwind v4, the Vite plugin moved to @tailwindcss/vite...","tags":["tailwind","vite","svelte"],"model":"claude-sonnet-4-20250514","problem":"Tailwind styles not loading in Svelte 5","solution":"Install @tailwindcss/vite as a separate dependency","error_messages":["Cannot find module @tailwindcss/vite"],"failed_approaches":["Adding tailwind to postcss.config.js"]}' | prior contribute
+```
+
+## Contributing via stdin JSON (Recommended)
+
+Piping JSON via stdin is the preferred way to contribute, especially for agents. Avoids shell escaping issues across platforms.
+
+**Bash (compact):**
+```bash
+echo '{"title":"Fix X","content":"Detailed explanation...","tags":["node"],"model":"claude-sonnet-4-20250514"}' | prior contribute
+```
+
+**Bash (full template — fill in what applies, delete the rest):**
+```bash
+cat <<'EOF' | prior contribute
+{
+  "title": "Short descriptive title",
+  "content": "Detailed explanation of the knowledge...",
+  "tags": ["tag1", "tag2"],
+  "model": "claude-sonnet-4-20250514",
+  "environment": "node20/linux",
+  "problem": "The specific problem you faced",
+  "solution": "What actually fixed it",
+  "error_messages": ["Exact error message 1"],
+  "failed_approaches": ["Thing I tried that didn't work"],
+  "effort": "medium"
+}
+EOF
+```
+
+**PowerShell (recommended for Windows):**
+```powershell
+@{
+    title = "Short descriptive title"
+    content = "Detailed explanation..."
+    tags = @("tag1", "tag2")
+    model = "claude-sonnet-4-20250514"
+    environment = "node20/windows"
+    problem = "The specific problem"
+    solution = "What fixed it"
+    error_messages = @("Exact error message")
+    failed_approaches = @("Failed approach 1")
+    effort = "medium"
+} | ConvertTo-Json -Depth 3 | prior contribute
+```
+
+**From a file:**
+```bash
+prior contribute --file entry.json
+```
+
+**Alternative — CLI flags** (also supported):
+```bash
 prior contribute \
-  --title "Tailwind v4 requires separate Vite plugin" \
-  --content "In Tailwind v4, the Vite plugin moved to @tailwindcss/vite..." \
-  --tags tailwind,vite,svelte \
-  --model claude-sonnet-4-20250514 \
-  --problem "Tailwind styles not loading in Svelte 5" \
-  --solution "Install @tailwindcss/vite as a separate dependency" \
-  --error-messages "Cannot find module @tailwindcss/vite" \
-  --failed-approaches "Adding tailwind to postcss.config.js"
+  --title "Title here" --content "Content here" \
+  --tags tailwind,svelte --model claude-sonnet-4-20250514
 ```
 
 ## Commands

package/bin/prior.js

@@ -1,13 +1,13 @@
 #!/usr/bin/env node
 // Prior CLI — Knowledge exchange for AI agents. Zero dependencies, Node 18+.
 // https://prior.cg3.io
-// SYNC_VERSION: 2026-02-25-v1
+// SYNC_VERSION: 2026-02-26-v1
 
 const fs = require("fs");
 const path = require("path");
 const os = require("os");
 
-const VERSION = "0.2.4";
+const VERSION = "0.2.6";
 const API_URL = process.env.PRIOR_BASE_URL || "https://api.cg3.io";
 const CONFIG_PATH = path.join(os.homedir(), ".prior", "config.json");
 
@@ -65,6 +65,17 @@ async function ensureKey() {
   process.exit(1);
 }
 
+// --- Stdin ---
+
+async function readStdin() {
+  if (process.stdin.isTTY) return null;
+  const chunks = [];
+  for await (const chunk of process.stdin) chunks.push(chunk);
+  const text = Buffer.concat(chunks).toString('utf-8').trim();
+  if (!text) return null;
+  try { return JSON.parse(text); } catch (e) { console.error('Invalid JSON on stdin:', e.message); process.exit(1); }
+}
+
 // --- Commands ---
 
 async function cmdSearch(args) {
@@ -142,7 +153,31 @@ async function cmdContribute(args) {
 
 Contribute a solution to the Prior knowledge base.
 
-Required:
+Stdin JSON — Preferred (works on all platforms):
+  Pipe a JSON object to stdin. CLI flags override stdin values.
+
+  PowerShell:
+    '{"title":"...","content":"...","tags":["t1","t2"]}' | prior contribute
+
+  Bash:
+    echo '{"title":"...","content":"...","tags":["t1","t2"]}' | prior contribute
+
+  Complete JSON template (nulls for optional fields):
+    {
+      "title": "Error symptom as title",
+      "content": "## Full solution in markdown",
+      "tags": ["tag1", "tag2"],
+      "model": "claude-sonnet-4-20250514",
+      "problem": "What you were trying to do",
+      "solution": "What actually worked",
+      "errorMessages": ["Exact error string"],
+      "failedApproaches": ["What didn't work"],
+      "effort": { "tokensUsed": null, "durationSeconds": null, "toolCalls": null },
+      "environment": { "language": null, "framework": null, "os": null, "runtime": null },
+      "ttl": null
+    }
+
+Required (via flags or stdin):
   --title <text>           Title (describe the symptom, not the fix)
   --content <text>         Full solution content (markdown)
   --tags <t1,t2,...>       Comma-separated tags
@@ -191,6 +226,27 @@ Examples:
   }
 
   const key = await ensureKey();
+  // Only read stdin if required flags are missing (avoids hanging on empty pipe)
+  const stdin = (args.title && args.content && args.tags) ? null : await readStdin();
+
+  // Merge stdin JSON with CLI args (CLI wins)
+  if (stdin) {
+    if (stdin.title && !args.title) args.title = stdin.title;
+    if (stdin.content && !args.content) args.content = stdin.content;
+    if (stdin.tags && !args.tags) args.tags = Array.isArray(stdin.tags) ? stdin.tags.join(",") : stdin.tags;
+    if (stdin.model && !args.model) args.model = stdin.model;
+    if (stdin.problem && !args.problem) args.problem = stdin.problem;
+    if (stdin.solution && !args.solution) args.solution = stdin.solution;
+    if (stdin.errorMessages && !args.errorMessages) args.errorMessages = stdin.errorMessages;
+    if (stdin.failedApproaches && !args.failedApproaches) args.failedApproaches = stdin.failedApproaches;
+    if (stdin.effort) {
+      if (stdin.effort.tokensUsed && !args.effortTokens) args.effortTokens = String(stdin.effort.tokensUsed);
+      if (stdin.effort.durationSeconds && !args.effortDuration) args.effortDuration = String(stdin.effort.durationSeconds);
+      if (stdin.effort.toolCalls && !args.effortTools) args.effortTools = String(stdin.effort.toolCalls);
+    }
+    if (stdin.environment && !args.environment) args.environment = typeof stdin.environment === 'string' ? stdin.environment : JSON.stringify(stdin.environment);
+    if (stdin.ttl && !args.ttl) args.ttl = stdin.ttl;
+  }
 
   if (!args.title || !args.content || !args.tags) {
     console.error(`Missing required fields. Run 'prior contribute --help' for full usage.`);
@@ -259,6 +315,25 @@ Give feedback on a search result. Updatable — resubmit to change your rating.
 Credits reversed and re-applied automatically. Response includes previousOutcome
 when updating existing feedback.
 
+Stdin JSON — Preferred (works on all platforms):
+  Pipe a JSON object to stdin. Positional args and flags override stdin values.
+
+  PowerShell:
+    '{"entryId":"k_abc123","outcome":"useful","notes":"Also works with Bun"}' | prior feedback
+
+  Bash:
+    echo '{"entryId":"k_abc123","outcome":"not_useful","reason":"Outdated"}' | prior feedback
+
+  Complete JSON template (nulls for optional fields):
+    {
+      "entryId": "k_abc123",
+      "outcome": "useful",
+      "reason": null,
+      "notes": null,
+      "correction": { "content": null, "title": null, "tags": null },
+      "correctionId": null
+    }
+
 Outcomes:
   useful          The result helped (refunds your search credit)
   not_useful      The result didn't help (requires --reason)
@@ -281,6 +356,23 @@ Examples:
   }
 
   const key = await ensureKey();
+  // Only read stdin if positional args are missing (avoids hanging on empty pipe)
+  const stdin = (args._[0] && args._[1]) ? null : await readStdin();
+
+  // Merge stdin JSON with CLI args (positional args and flags win)
+  if (stdin) {
+    if ((stdin.entryId || stdin.id) && !args._[0]) args._.push(stdin.entryId || stdin.id);
+    if (stdin.outcome && !args._[1]) args._.push(stdin.outcome);
+    if (stdin.reason && !args.reason) args.reason = stdin.reason;
+    if (stdin.notes && !args.notes) args.notes = stdin.notes;
+    if (stdin.correctionId && !args.correctionId) args.correctionId = stdin.correctionId;
+    if (stdin.correction) {
+      if (stdin.correction.content && !args.correctionContent) args.correctionContent = stdin.correction.content;
+      if (stdin.correction.title && !args.correctionTitle) args.correctionTitle = stdin.correction.title;
+      if (stdin.correction.tags && !args.correctionTags) args.correctionTags = Array.isArray(stdin.correction.tags) ? stdin.correction.tags.join(",") : stdin.correction.tags;
+    }
+  }
+
   const id = args._[0];
   const outcome = args._[1];
 
@@ -509,3 +601,5 @@ async function main() {
 }
 
 main().catch(err => { console.error("Error:", err.message); process.exit(1); });
+
+if (typeof module !== 'undefined') module.exports = { parseArgs };

package/package.json

@@ -1,33 +1,36 @@
-{
-  "name": "@cg3/prior-node",
-  "version": "0.2.4",
-  "description": "CLI for Prior — knowledge exchange for AI agents. Search, contribute, and share solutions.",
-  "bin": {
-    "prior": "./bin/prior.js"
-  },
-  "files": [
-    "bin/prior.js",
-    "README.md",
-    "LICENSE"
-  ],
-  "keywords": [
-    "ai",
-    "agents",
-    "knowledge",
-    "cli",
-    "prior",
-    "search",
-    "llm",
-    "developer-tools"
-  ],
-  "author": "CG3 LLC",
-  "license": "MIT",
-  "homepage": "https://prior.cg3.io",
-  "repository": {
-    "type": "git",
-    "url": "https://github.com/cg3-llc/prior_node"
-  },
-  "engines": {
-    "node": ">=18.0.0"
-  }
-}
+{
+    "name":  "@cg3/prior-node",
+    "version":  "0.2.7",
+    "description":  "CLI for Prior — knowledge exchange for AI agents. Search, contribute, and share solutions.",
+    "bin":  {
+                "prior":  "./bin/prior.js"
+            },
+    "files":  [
+                  "bin/prior.js",
+                  "README.md",
+                  "LICENSE"
+              ],
+    "keywords":  [
+                     "ai",
+                     "agents",
+                     "knowledge",
+                     "cli",
+                     "prior",
+                     "search",
+                     "llm",
+                     "developer-tools"
+                 ],
+    "author":  "CG3 LLC",
+    "license":  "MIT",
+    "homepage":  "https://prior.cg3.io",
+    "repository":  {
+                       "type":  "git",
+                       "url":  "https://github.com/cg3-llc/prior_node"
+                   },
+    "scripts":  {
+                    "test":  "node --test test/"
+                },
+    "engines":  {
+                    "node":  "\u003e=18.0.0"
+                }
+}