careervivid 1.6.0 → 1.7.0

package/dist/api.d.ts

@@ -39,6 +39,7 @@ export interface ApiError {
     }[];
 }
 export declare function publishPost(payload: PublishPayload, dryRun?: boolean): Promise<PublishResult | ApiError>;
+export declare function updatePost(postId: string, payload: Partial<PublishPayload>): Promise<PublishResult | ApiError>;
 /**
  * Verify an API key against the /verifyAuth endpoint.
  * Optionally accepts a specific key (for set-key validation).

package/dist/api.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"api.d.ts","sourceRoot":"","sources":["../src/api.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAMH,MAAM,MAAM,QAAQ,GAAG,SAAS,GAAG,YAAY,CAAC;AAChD,MAAM,MAAM,UAAU,GAAG,UAAU,GAAG,SAAS,CAAC;AAEhD,MAAM,WAAW,cAAc;IAC3B,IAAI,EAAE,QAAQ,CAAC;IACf,UAAU,EAAE,UAAU,CAAC;IACvB,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC;IAChB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,cAAc,CAAC,EAAE,OAAO,CAAC;CAC5B;AAED,MAAM,WAAW,aAAa;IAC1B,OAAO,EAAE,OAAO,CAAC;IACjB,MAAM,EAAE,MAAM,CAAC;IACf,GAAG,EAAE,MAAM,CAAC;IACZ,OAAO,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,YAAY;IACzB,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;IACrB,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,OAAO,CAAC;CACpB;AAED,MAAM,WAAW,QAAQ;IACrB,OAAO,EAAE,IAAI,CAAC;IACd,UAAU,EAAE,MAAM,CAAC;IACnB,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,CAAC,EAAE;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE,EAAE,CAAC;CACjD;AAmED,wBAAsB,WAAW,CAC7B,OAAO,EAAE,cAAc,EACvB,MAAM,UAAQ,GACf,OAAO,CAAC,aAAa,GAAG,QAAQ,CAAC,CAgBnC;AAED;;;GAGG;AACH,wBAAsB,SAAS,CAAC,GAAG,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,YAAY,GAAG,QAAQ,CAAC,CAwC9E;AAED;;GAEG;AACH,wBAAsB,QAAQ,IAAI,OAAO,CAAC;IAAE,EAAE,EAAE,OAAO,CAAC;IAAC,KAAK,CAAC,EAAE,MAAM,CAAA;CAAE,CAAC,CAMzE;AAED,wBAAsB,aAAa,CAAC,KAAK,CAAC,EAAE,MAAM,EAAE,UAAU,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC;IAAE,OAAO,EAAE,OAAO,CAAC;IAAC,WAAW,EAAE,MAAM,CAAC;IAAC,GAAG,EAAE,MAAM,CAAA;CAAE,GAAG,QAAQ,CAAC,CAEnJ;AAED,wBAAsB,uBAAuB,CAAC,WAAW,EAAE,MAAM,EAAE,QAAQ,EAAE,GAAG,EAAE,EAAE,SAAS,CAAC,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC;IAAE,OAAO,EAAE,OAAO,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,GAAG,QAAQ,CAAC,CAEnK;AAED,wBAAsB,mBAAmB,CAAC,WAAW,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,GAAG,EAAE,KAAK,CAAC,EAAE,GAAG,EAAE,WAAW,CAAC,EAAE,GAAG,GAAG,OAAO,CAAC;IAAE,OAAO,EAAE,OAAO,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,GAAG,QAAQ,CAAC,CAEpK;AAED,wBAAsB,oBAAoB,CAAC,KAAK,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC;IAAE,OAAO,EAAE,OAAO,CAAC;IAAC,WAAW,EAAE,MAAM,CAAA;CAAE,GAAG,QAAQ,CAAC,CAEvJ;AAED,wBAAgB,UAAU,CAAC,CAAC,EAAE,OAAO,GAAG,CAAC,IAAI,QAAQ,CAEpD"}
+{"version":3,"file":"api.d.ts","sourceRoot":"","sources":["../src/api.ts"],"names":[],"mappings":"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"}

package/dist/api.js

@@ -6,7 +6,7 @@
  */
 import { getApiKey, getApiUrl } from "./config.js";
 // ── Helpers ───────────────────────────────────────────────────────────────────
-const CLI_VERSION = "1.6.0";
+const CLI_VERSION = "1.7.0";
 function requireApiKey() {
     const key = getApiKey();
     if (!key) {
@@ -73,6 +73,9 @@ export async function publishPost(payload, dryRun = false) {
     }
     return apiRequest("POST", "publish", payload);
 }
+export async function updatePost(postId, payload) {
+    return apiRequest("PATCH", "publish", { ...payload, postId });
+}
 /**
  * Verify an API key against the /verifyAuth endpoint.
  * Optionally accepts a specific key (for set-key validation).

package/dist/commands/publish.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"publish.d.ts","sourceRoot":"","sources":["../../src/commands/publish.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAkIpC,wBAAgB,sBAAsB,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI,CA8F7D"}
+{"version":3,"file":"publish.d.ts","sourceRoot":"","sources":["../../src/commands/publish.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AA8KpC,wBAAgB,sBAAsB,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI,CA6J7D"}

package/dist/commands/publish.js

@@ -53,12 +53,31 @@ function getFiles(dir, recursive) {
 }
 async function publishSingleFile(filePath, content, opts, jsonMode) {
     const dryRun = !!opts.dryRun;
+    // ── Parse Frontmatter ───────────────────────────────────────────
+    let postId = undefined;
+    let cleanContent = content;
+    // Robust frontmatter extraction (multiline, flexible spacing)
+    const frontmatterMatch = content.match(/^---\s*[\r\n]+([\s\S]*?)[\r\n]+---\s*[\r\n]+/);
+    if (frontmatterMatch) {
+        const fm = frontmatterMatch[1];
+        // Match postId with potential leading/trailing whitespace or quotes
+        const idMatch = fm.match(/postId:\s*["']?([a-zA-Z0-9_-]+)["']?/i);
+        postId = idMatch?.[1];
+        cleanContent = content.slice(frontmatterMatch[0].length);
+    }
+    // Fail if onlyUpdate is set but no postId is found
+    if (opts.onlyUpdate && !postId) {
+        if (!jsonMode) {
+            console.error(chalk.red(`\n  ✖  Missing postId frontmatter in ${filePath}. Use 'cv publish' to create a new post.`));
+        }
+        return { success: false };
+    }
     const format = opts.format ||
         (filePath !== "stdin" ? inferFormat(filePath) : "markdown");
     const type = opts.type || inferType(format);
     let title = opts.title || "";
     if (!title && format === "markdown") {
-        const firstHeading = content.match(/^#\s+(.+)$/m);
+        const firstHeading = cleanContent.match(/^#\s+(.+)$/m);
         if (firstHeading) {
             title = firstHeading[1].trim();
         }
@@ -86,21 +105,43 @@ async function publishSingleFile(filePath, content, opts, jsonMode) {
         type,
         dataFormat: format,
         title,
-        content,
+        content: cleanContent,
         tags,
         ...(opts.cover ? { coverImage: opts.cover } : {}),
         ...(opts.official ? { isOfficialPost: true } : {}),
     };
-    const result = await publishPost(payload, dryRun);
+    let result;
+    if (postId && !dryRun) {
+        const { updatePost } = await import("../api.js");
+        result = await updatePost(postId, payload);
+    }
+    else {
+        result = await publishPost(payload, dryRun);
+    }
     if (isApiError(result)) {
         if (jsonMode) {
             handleApiError(result, true);
         }
         else {
-            console.error(chalk.red(`\n  ✖  Failed to publish ${filePath}: ${result.message}`));
+            console.error(chalk.red(`\n  ✖  Failed to ${postId ? "update" : "publish"} ${filePath}: ${result.message}`));
         }
         return { success: false };
     }
+    // ── Write back postId if it's new ────────────────────────────────
+    if (!postId && !dryRun && filePath !== "stdin" && result.postId) {
+        const newFm = `---\npostId: ${result.postId}\n---\n\n`;
+        const updatedFileContent = newFm + content;
+        try {
+            const { writeFileSync } = await import("fs");
+            writeFileSync(filePath, updatedFileContent, "utf-8");
+        }
+        catch (err) {
+            // Non-fatal error
+            if (!jsonMode) {
+                console.warn(chalk.yellow(`  ⚠  Could not write postId to ${filePath}`));
+            }
+        }
+    }
     return {
         success: true,
         url: result.url,
@@ -198,4 +239,62 @@ export function registerPublishCommand(program) {
             console.log(`\n  ${chalk.yellow("Dry run complete.")} Validated ${chalk.bold(fileList.length)} files.\n`);
         }
     });
+    program
+        .command("update [files...]")
+        .description("Update existing content on CareerVivid (requires postId in frontmatter)")
+        .option("-t, --title <title>", "Override post title")
+        .option("--tags <tags>", "Comma-separated tags")
+        .option("--dry-run", "Validate without updating")
+        .option("--json", "Machine-readable output")
+        .option("-r, --recursive", "Recursively scan directories")
+        .action(async (files, opts) => {
+        const extendedOpts = { ...opts, onlyUpdate: true };
+        const jsonMode = !!opts.json;
+        const dryRun = !!opts.dryRun;
+        let fileList = [];
+        if (files.length === 0) {
+            printError("No files specified to update.", undefined, jsonMode);
+            process.exit(1);
+        }
+        for (const arg of files) {
+            try {
+                const stat = lstatSync(arg);
+                if (stat.isDirectory()) {
+                    fileList = fileList.concat(getFiles(arg, !!opts.recursive));
+                }
+                else {
+                    fileList.push(arg);
+                }
+            }
+            catch (err) {
+                printError(`Cannot find path: ${arg}`, undefined, jsonMode);
+                process.exit(1);
+            }
+        }
+        if (!jsonMode && !dryRun) {
+            console.log(`\n  ${chalk.bold("Preparing to update")} ${chalk.cyan(fileList.length)} ${fileList.length === 1 ? "file" : "files"}...`);
+        }
+        const results = [];
+        let successCount = 0;
+        for (const filePath of fileList) {
+            const content = readFileSync(filePath, "utf-8");
+            const spinner = (!jsonMode && !dryRun) ? ora(`Updating ${chalk.cyan(filePath)}...`).start() : null;
+            const res = await publishSingleFile(filePath, content, extendedOpts, jsonMode);
+            spinner?.stop();
+            if (res.success) {
+                successCount++;
+                results.push({ file: filePath, ...res });
+                if (!jsonMode && !dryRun) {
+                    console.log(`  ${chalk.green("✔")}  Updated: ${chalk.bold(res.title)}`);
+                    console.log(`     ${chalk.dim(res.url)}`);
+                }
+            }
+        }
+        if (jsonMode) {
+            console.log(JSON.stringify(results, null, 2));
+        }
+        else if (!dryRun) {
+            console.log(`\n  ${chalk.green("Done!")} Successfully updated ${chalk.bold(successCount)} of ${chalk.bold(fileList.length)} files.\n`);
+        }
+    });
 }

package/dist/commands/update.js

@@ -10,7 +10,7 @@ import { spawn } from "child_process";
 import { getHelpHeader } from "../branding.js";
 export function registerUpdateCommand(program) {
     program
-        .command("update")
+        .command("upgrade")
         .description("Upgrade the CareerVivid CLI to the latest version")
         .action(async () => {
         console.log(getHelpHeader());

package/dist/index.d.ts

@@ -15,7 +15,8 @@
  *   cv config show                    Print current configuration
  *   cv config set <key> <value>       Update a config value
  *   cv config get <key>               Print a config value
- *   cv update                         Upgrade the CLI to the latest version
+ *   cv upgrade                        Upgrade the CLI to the latest version
+ *   cv update [files...]              Update existing content on CareerVivid
  *   cv --help / cv --version
  */
 export {};

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";AACA;;;;;;;;;;;;;;;;;;GAkBG"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";AACA;;;;;;;;;;;;;;;;;;;GAmBG"}

package/dist/index.js

@@ -15,7 +15,8 @@
  *   cv config show                    Print current configuration
  *   cv config set <key> <value>       Update a config value
  *   cv config get <key>               Print a config value
- *   cv update                         Upgrade the CLI to the latest version
+ *   cv upgrade                        Upgrade the CLI to the latest version
+ *   cv update [files...]              Update existing content on CareerVivid
  *   cv --help / cv --version
  */
 import { Command } from "commander";

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "careervivid",
-  "version": "1.6.0",
+  "version": "1.7.0",
   "description": "Official CLI for CareerVivid — publish articles, diagrams, and portfolio updates from your terminal or AI agent",
   "type": "module",
   "bin": {