pnote 0.4.0 → 0.4.2

package/README.md

@@ -21,7 +21,7 @@ pnote notes
 pnote notes get abc123
 
 # Copy snippet to clipboard
-pnote snippet copy abc123
+pnote notes snippet copy abc123
 
 # Search
 pnote search "portrait"
@@ -45,7 +45,9 @@ pnote notes                    # List all notes
 pnote notes --tag "AI/art"     # Filter by tag
 pnote notes --archived         # Show archived
 pnote notes --pinned           # Show pinned only
+pnote notes --protected        # Show only PIN-protected notes
 pnote notes get <id>           # Get note details
+pnote notes get <id> --latest  # Get note with latest snippet only
 pnote notes create "Title"     # Create new note
 pnote notes update <id> --title "New Title"  # Update title
 pnote notes update <id> --tags a b c         # Replace tags
@@ -57,12 +59,12 @@ pnote notes delete <id>        # Delete note
 ### Snippets
 
 ```bash
-pnote snippet <note-id>           # Show latest snippet
-pnote snippet <note-id> --all     # Show all versions
-pnote snippet copy <note-id>      # Copy to clipboard
-echo "content" | pnote snippet add <note-id>  # Add new version
-echo "updated" | pnote snippet update <snippet-id>  # Update existing
-pnote snippet favorite <snippet-id>  # Toggle favorite
+pnote notes snippet <note-id>                        # Show latest snippet (pipe-friendly)
+pnote notes snippet list <note-id>                   # List all versions
+pnote notes snippet copy <note-id>                   # Copy to clipboard
+echo "content" | pnote notes snippet add <note-id>      # Add new version
+echo "updated" | pnote notes snippet update <snippet-id> # Update existing
+pnote notes snippet favorite <snippet-id>                 # Toggle favorite
 ```
 
 ### Tags
@@ -90,6 +92,38 @@ pnote search "query" --notes-only # Notes only
 pnote search "query" --limit 50   # Limit results
 ```
 
+
+### PIN Protection
+
+Notes can be PIN-protected (encrypted server-side). Set your PIN in the PromptNote web app under Settings.
+
+```bash
+pnote pin status                   # Check PIN configuration and cache status
+pnote pin list                     # List protected notes (metadata only)
+
+# Access protected notes
+PNOTE_PIN=1234 pnote notes --protected
+PNOTE_PIN=1234 pnote notes get <protected-note-id>
+echo "1234" | pnote notes get <id> --pin-stdin
+```
+
+**PIN resolution order:** `-p` flag → `--pin-stdin` → `PNOTE_PIN` env var → 5-min session cache → interactive prompt (TTY only).
+
+### Agent Skills Sync
+
+Sync agent skill files between PromptNote cloud and your local agent directories.
+
+```bash
+pnote skills                          # List skills in cloud
+pnote skills pull                     # Pull all globally (~/.agents/skills/ + symlinks)
+pnote skills pull <name>              # Pull a specific skill globally
+pnote skills pull --project           # Pull project-level (.agents/skills/ + symlinks)
+pnote skills pull --dry-run           # Preview without writing files
+pnote skills push <dir>               # Upload local skill directory to cloud
+```
+
+Skills are written to `.agents/skills/<name>/` (canonical store) and symlinked into `.claude/skills/`, `.windsurf/skills/`, and other installed agent directories automatically.
+
 ## Global Options
 
 | Option | Description |
@@ -105,6 +139,7 @@ pnote search "query" --limit 50   # Limit results
 | Variable | Description |
 |----------|-------------|
 | `PNOTE_TOKEN` | PAT token (overrides stored credentials) |
+| `PNOTE_PIN` | PIN for accessing protected notes |
 | `NO_COLOR` | Disable colors |
 | `PNOTE_API_ENDPOINT` | Custom API endpoint |
 

package/dist/index.js

@@ -1,7 +1,7 @@
 #!/usr/bin/env node
 
 // src/index.ts
-import { Command as Command10 } from "commander";
+import { Command as Command12 } from "commander";
 
 // src/lib/errors.ts
 import pc from "picocolors";
@@ -957,10 +957,10 @@ async function confirm(message) {
     input: process.stdin,
     output: process.stdout
   });
-  return new Promise((resolve2) => {
+  return new Promise((resolve3) => {
     rl.question(message + " [y/N] ", (answer) => {
       rl.close();
-      resolve2(answer.toLowerCase() === "y" || answer.toLowerCase() === "yes");
+      resolve3(answer.toLowerCase() === "y" || answer.toLowerCase() === "yes");
     });
   });
 }
@@ -1284,7 +1284,7 @@ async function promptForPin(noteTitle, hint, maxAttempts = PIN_MAX_ATTEMPTS) {
   return null;
 }
 async function readPinHidden(prompt) {
-  return new Promise((resolve2) => {
+  return new Promise((resolve3) => {
     const rl = createInterface2({
       input: process.stdin,
       output: process.stderr,
@@ -1300,7 +1300,7 @@ async function readPinHidden(prompt) {
       if (char === "\r" || char === "\n") {
         process.stderr.write("\n");
         cleanup();
-        resolve2(pin);
+        resolve3(pin);
       } else if (char === "") {
         process.stderr.write("\n");
         cleanup();
@@ -1831,63 +1831,172 @@ import * as fs from "fs";
 import * as path from "path";
 import * as os from "os";
 import pc11 from "picocolors";
+var AGENTS_STORE = ".agents/skills";
+var AGENT_SYMLINK_DIRS = [
+  ".claude/skills",
+  ".windsurf/skills",
+  ".augment/skills",
+  ".agent/skills"
+];
+function makeColors(useColor) {
+  if (useColor) {
+    return {
+      green: pc11.green,
+      dim: pc11.dim,
+      yellow: pc11.yellow,
+      bold: pc11.bold,
+      red: pc11.red
+    };
+  }
+  return {
+    green: (s) => s,
+    dim: (s) => s,
+    yellow: (s) => s,
+    bold: (s) => s,
+    red: (s) => s
+  };
+}
+function resolveMode(options) {
+  if (options.dir) return { mode: "custom", root: path.resolve(options.dir) };
+  if (options.project) return { mode: "project", root: process.cwd() };
+  return { mode: "global", root: os.homedir() };
+}
+function ensureSymlink(linkPath, skillName, dryRun, c, log) {
+  const relTarget = path.join("..", "..", AGENTS_STORE, skillName);
+  if (dryRun) {
+    log(`  ${c.dim("would link")} ${linkPath} \u2192 ${relTarget}`);
+    return;
+  }
+  fs.mkdirSync(path.dirname(linkPath), { recursive: true });
+  let existingStat = null;
+  try {
+    existingStat = fs.lstatSync(linkPath);
+  } catch {
+  }
+  if (existingStat) {
+    if (existingStat.isSymbolicLink()) {
+      if (fs.readlinkSync(linkPath) === relTarget) return;
+      fs.unlinkSync(linkPath);
+    } else if (existingStat.isDirectory()) {
+      fs.rmSync(linkPath, { recursive: true });
+      log(`  ${c.yellow("\u2197")} migrated ${c.dim(linkPath)} (replaced directory with symlink)`);
+    } else {
+      fs.unlinkSync(linkPath);
+    }
+  }
+  fs.symlinkSync(relTarget, linkPath);
+  log(`  ${c.dim("\u21E2")} ${linkPath}`);
+}
+function installSkill(root, mode, skillName, files, dryRun, c, log) {
+  const home = os.homedir();
+  if (mode === "custom") {
+    for (const { fileName, content } of files) {
+      const destPath = path.join(root, skillName, fileName);
+      if (dryRun) {
+        log(`  ${c.dim("would write")} ${destPath}`);
+      } else {
+        fs.mkdirSync(path.dirname(destPath), { recursive: true });
+        fs.writeFileSync(destPath, content, "utf-8");
+        log(`  ${c.green("\u2713")} ${destPath}`);
+      }
+    }
+    return [];
+  }
+  for (const { fileName, content } of files) {
+    const destPath = path.join(root, AGENTS_STORE, skillName, fileName);
+    if (dryRun) {
+      log(`  ${c.dim("would write")} ${destPath}`);
+    } else {
+      fs.mkdirSync(path.dirname(destPath), { recursive: true });
+      fs.writeFileSync(destPath, content, "utf-8");
+      log(`  ${c.green("\u2713")} ${destPath}`);
+    }
+  }
+  const linkedAgents = [];
+  for (const agentSkillsDir of AGENT_SYMLINK_DIRS) {
+    const agentRootDir = agentSkillsDir.split("/")[0];
+    const isClaude = agentRootDir === ".claude";
+    if (!isClaude && !fs.existsSync(path.join(home, agentRootDir))) continue;
+    const linkPath = path.join(root, agentSkillsDir, skillName);
+    ensureSymlink(linkPath, skillName, dryRun, c, log);
+    linkedAgents.push(agentRootDir);
+  }
+  return linkedAgents;
+}
 async function pullSkillsAction(skillName, options, ctx) {
   try {
-    const baseDir = options.dir || path.join(os.homedir(), ".claude", "skills");
+    const { mode, root } = resolveMode(options);
+    const useColor = !ctx.noColor && process.stdout.isTTY;
+    const c = makeColors(useColor);
+    const log = ctx.json ? (_msg) => {
+    } : (msg) => console.log(msg);
     const result = await listNotes(
       { note_type: "skill", limit: 200 },
       { pin: ctx.pin }
     );
     let skills = result.notes;
     if (skillName) {
-      skills = skills.filter((n) => {
-        const prefix = n.title.split("/")[0];
-        return prefix === skillName;
-      });
+      skills = skills.filter((n) => n.title.split("/")[0] === skillName);
       if (skills.length === 0) {
         console.error(pc11.red(`No skill found with name "${skillName}"`));
         process.exit(1);
       }
     }
     if (skills.length === 0) {
-      console.log(pc11.dim("No skills to pull."));
+      if (!ctx.json) console.log(c.dim("No skills to pull."));
+      if (ctx.json) outputJson({ pulled: 0, skipped: 0, mode, root, skills: {} });
       return;
     }
-    let pulled = 0;
-    let skipped = 0;
+    const grouped = /* @__PURE__ */ new Map();
     for (const note of skills) {
       const slashIdx = note.title.indexOf("/");
       if (slashIdx <= 0) {
-        logStatus(`Skipping "${note.title}" (invalid title format, expected "name/file")`);
-        skipped++;
+        if (!ctx.json) console.error(`Skipping "${note.title}" (invalid title format, expected "name/file")`);
         continue;
       }
-      const skillDir = note.title.slice(0, slashIdx);
+      const sName = note.title.slice(0, slashIdx);
       const fileName = note.title.slice(slashIdx + 1);
-      const filePath = path.join(baseDir, skillDir, fileName);
-      const noteData = await getNote(note.id, { pin: ctx.pin });
-      const content = noteData.latest_snippet?.content;
-      if (!content) {
-        logStatus(`Skipping "${note.title}" (no snippet content)`);
-        skipped++;
-        continue;
+      if (!grouped.has(sName)) grouped.set(sName, []);
+      grouped.get(sName).push({ fileName, noteId: note.id });
+    }
+    let totalPulled = 0;
+    let totalSkipped = 0;
+    const jsonResults = {};
+    for (const [sName, fileEntries] of grouped) {
+      log(`
+${c.bold(sName)}`);
+      const files = [];
+      for (const { fileName, noteId } of fileEntries) {
+        const noteData = await getNote(noteId, { pin: ctx.pin });
+        const content = noteData.latest_snippet?.content;
+        if (!content) {
+          if (!ctx.json) console.error(`  Skipping "${sName}/${fileName}" (no snippet content)`);
+          totalSkipped++;
+          continue;
+        }
+        files.push({ fileName, content });
       }
+      if (files.length === 0) continue;
+      const linkedAgents = installSkill(root, mode, sName, files, options.dryRun ?? false, c, log);
+      totalPulled += files.length;
+      jsonResults[sName] = {
+        files: files.map((f) => f.fileName),
+        agents: linkedAgents
+      };
+    }
+    if (!ctx.json) {
+      console.log("");
       if (options.dryRun) {
-        console.log(`${pc11.dim("would write")} ${filePath} ${pc11.dim(`(${content.length} chars)`)}`);
-        pulled++;
-        continue;
+        console.log(c.dim(`Dry run: ${totalPulled} file(s) would be pulled, ${totalSkipped} skipped`));
+      } else {
+        const scopeLabel = mode === "custom" ? root : mode === "project" ? "project (.agents/skills/)" : "global (~/.agents/skills/)";
+        console.log(
+          `Pulled ${totalPulled} file(s) \u2014 ${scopeLabel}` + (totalSkipped > 0 ? `, ${totalSkipped} skipped` : "")
+        );
       }
-      const dir = path.dirname(filePath);
-      fs.mkdirSync(dir, { recursive: true });
-      fs.writeFileSync(filePath, content, "utf-8");
-      console.log(`${pc11.green("\u2713")} ${filePath}`);
-      pulled++;
     }
-    console.log("");
-    if (options.dryRun) {
-      console.log(pc11.dim(`Dry run: ${pulled} file(s) would be written, ${skipped} skipped`));
-    } else {
-      console.log(`Pulled ${pulled} file(s) to ${baseDir}` + (skipped > 0 ? `, ${skipped} skipped` : ""));
+    if (ctx.json) {
+      outputJson({ pulled: totalPulled, skipped: totalSkipped, mode, root, skills: jsonResults });
     }
   } catch (error) {
     handleError(error, ctx.noColor);
@@ -1994,16 +2103,20 @@ var skillsCommand = new Command8("skills").description("Manage agent skills (syn
   "after",
   `
 Examples:
-  $ pnote skills                     List all skills in cloud
-  $ pnote skills pull                Download all skills to ~/.claude/skills/
-  $ pnote skills pull myskill        Download a specific skill
-  $ pnote skills push ./my-skill     Upload a local skill directory
+  $ pnote skills                        List all skills in cloud
+  $ pnote skills pull                   Pull all skills globally (~/.agents/skills/ + symlinks)
+  $ pnote skills pull myskill           Pull a specific skill globally
+  $ pnote skills pull --project         Pull project-level (.agents/skills/ + .claude/skills/ etc.)
+  $ pnote skills pull --dry-run         Preview without writing files
+  $ pnote skills push ./my-skill        Upload a local skill directory
 
-Skills are notes with type "skill" and title format "skill-name/filename.md".
-They sync to ~/.claude/skills/<skill-name>/<filename> for use with Claude Code.
+Skills are stored as notes with type "skill" and title "skill-name/filename.md".
+Pull writes to the canonical .agents/skills/ store and symlinks into each installed
+agent's directory (.claude/skills/, .windsurf/skills/, .augment/skills/, etc.),
+matching the layout used by npx skills for seamless coexistence.
 `
 );
-skillsCommand.command("pull").description("Download skills from cloud to local (~/.claude/skills/)").argument("[skill-name]", "Specific skill to pull (pulls all if omitted)").option("--dir <path>", "Custom output directory (default: ~/.claude/skills)").option("--dry-run", "Show what would be downloaded without writing files").action(async (skillName, options, cmd) => {
+skillsCommand.command("pull").description("Download skills from cloud to local (global by default)").argument("[skill-name]", "Specific skill to pull (pulls all if omitted)").option("--project", "Install project-level (./agents/skills/ + .claude/skills/ etc.)").option("--dir <path>", "Custom output directory \u2014 direct write, no symlinks").option("--dry-run", "Show what would be downloaded without writing files").action(async (skillName, options, cmd) => {
   const globalOpts = cmd.parent?.parent?.opts() || {};
   const ctx = await buildContext6(globalOpts);
   await pullSkillsAction(skillName, options, ctx);
@@ -2175,7 +2288,7 @@ pinCommand.command("list").description("List all PIN-protected notes (metadata o
 });
 
 // src/lib/update-check.ts
-import { existsSync as existsSync4, readFileSync as readFileSync4, writeFileSync as writeFileSync4, mkdirSync as mkdirSync3 } from "fs";
+import { existsSync as existsSync5, readFileSync as readFileSync4, writeFileSync as writeFileSync4, mkdirSync as mkdirSync3 } from "fs";
 import { join as join5 } from "path";
 import pc15 from "picocolors";
 var CACHE_FILE = "update-check.json";
@@ -2187,7 +2300,7 @@ function getCachePath() {
 function readCache() {
   try {
     const path3 = getCachePath();
-    if (!existsSync4(path3)) return null;
+    if (!existsSync5(path3)) return null;
     return JSON.parse(readFileSync4(path3, "utf-8"));
   } catch {
     return null;
@@ -2196,7 +2309,7 @@ function readCache() {
 function writeCache(cache) {
   try {
     const dir = getConfigDir();
-    if (!existsSync4(dir)) {
+    if (!existsSync5(dir)) {
       mkdirSync3(dir, { recursive: true, mode: 448 });
     }
     writeFileSync4(getCachePath(), JSON.stringify(cache), "utf-8");
@@ -2273,9 +2386,95 @@ async function checkAndNotifyUpdate(currentVersion, packageName) {
   }
 }
 
+// src/commands/update.ts
+import { Command as Command10 } from "commander";
+import { spawnSync } from "child_process";
+import pc16 from "picocolors";
+function isOlderVersion2(current, latest) {
+  const parse = (v) => v.split(".").map(Number);
+  const [cMaj, cMin, cPat] = parse(current);
+  const [lMaj, lMin, lPat] = parse(latest);
+  if (cMaj !== lMaj) return cMaj < lMaj;
+  if (cMin !== lMin) return cMin < lMin;
+  return cPat < lPat;
+}
+function detectPackageManager() {
+  const ua = process.env.npm_config_user_agent ?? "";
+  if (ua.startsWith("pnpm")) return "pnpm";
+  return "npm";
+}
+var updateCommand = new Command10("update").description("Check for updates and upgrade to the latest version").action(async () => {
+  const noColor = !process.stderr.isTTY || !!process.env.NO_COLOR || process.env.TERM === "dumb";
+  const bold = noColor ? (s) => s : pc16.bold;
+  const dim = noColor ? (s) => s : pc16.dim;
+  const green = noColor ? (s) => s : pc16.green;
+  try {
+    process.stderr.write(dim("Checking for updates\u2026") + "\n");
+    const res = await fetch(
+      `https://registry.npmjs.org/${"pnote"}/latest`,
+      { signal: AbortSignal.timeout(5e3) }
+    );
+    if (!res.ok) throw new Error(`Registry returned ${res.status}`);
+    const data = await res.json();
+    const latest = data.version;
+    const current = "0.4.2";
+    if (!isOlderVersion2(current, latest)) {
+      console.log(green("\u2713") + ` Already on the latest version (${bold("v" + current)})`);
+      return;
+    }
+    const pm = detectPackageManager();
+    const installArgs = pm === "pnpm" ? ["add", "-g", "pnote"] : ["install", "-g", "pnote"];
+    const installCmd = `${pm} ${installArgs.join(" ")}`;
+    console.log(`Update available: ${dim("v" + current)} \u2192 ${bold("v" + latest)}`);
+    console.log(dim("Running: ") + bold(installCmd));
+    console.log("");
+    const result = spawnSync(pm, installArgs, { stdio: "inherit" });
+    if (result.status !== 0) {
+      process.exit(result.status ?? 1);
+    }
+    console.log("");
+    console.log(green("\u2713") + ` Updated to ${bold("v" + latest)}`);
+  } catch (err) {
+    handleError(err);
+  }
+});
+
+// src/commands/schema.ts
+import { Command as Command11 } from "commander";
+function mapOption(opt) {
+  const result = {
+    flags: opt.flags,
+    description: opt.description
+  };
+  if (opt.defaultValue !== void 0) {
+    result.defaultValue = opt.defaultValue;
+  }
+  return result;
+}
+function mapCommand(cmd) {
+  return {
+    name: cmd.name(),
+    description: cmd.description(),
+    aliases: cmd.aliases(),
+    options: cmd.options.map(mapOption),
+    subcommands: cmd.commands.map(mapCommand)
+  };
+}
+var schemaCommand = new Command11("schema").description("Output full command schema as JSON (for AI agent discovery)").action((_opts, cmd) => {
+  const root = cmd.parent ?? cmd;
+  const schema = {
+    name: root.name(),
+    version: "0.4.2",
+    description: root.description(),
+    globalOptions: root.options.map(mapOption),
+    commands: root.commands.map(mapCommand)
+  };
+  console.log(JSON.stringify(schema, null, 2));
+});
+
 // src/index.ts
-var program = new Command10();
-program.name("pnote").description("pnote - The PromptNote CLI").version("0.4.0", "-V, --version", "Show version number").option("--json", "Output as JSON (for scripting)").option("--no-color", "Disable colored output").option("--plain", "Force plain text output (no formatting)").option("-p, --pin <pin>", "PIN for accessing protected notes").option("--pin-stdin", "Read PIN from stdin (first line only)").configureHelp({
+var program = new Command12();
+program.name("pnote").description("pnote - The PromptNote CLI").version("0.4.2", "-V, --version", "Show version number").option("--json", "Output as JSON (for scripting)").option("--no-color", "Disable colored output").option("--plain", "Force plain text output (no formatting)").option("-p, --pin <pin>", "PIN for accessing protected notes").option("--pin-stdin", "Read PIN from stdin (first line only)").configureHelp({
   sortSubcommands: true,
   sortOptions: true
 }).addHelpText(
@@ -2307,8 +2506,10 @@ program.addCommand(searchCommand);
 program.addCommand(shareCommand);
 program.addCommand(pinCommand);
 program.addCommand(skillsCommand);
+program.addCommand(updateCommand);
+program.addCommand(schemaCommand);
 program.hook("preAction", async () => {
-  await checkAndNotifyUpdate("0.4.0", "pnote");
+  await checkAndNotifyUpdate("0.4.2", "pnote");
 });
 process.on("SIGINT", () => {
   console.error("\nInterrupted");