akm-cli 0.7.4 → 0.8.0-rc1

package/dist/core/common.js

@@ -8,6 +8,20 @@ export const IS_WINDOWS = process.platform === "win32";
 export function isHttpUrl(value) {
     return !!value && /^https?:\/\//.test(value);
 }
+/**
+ * Returns `true` when `value` looks like a remote URL that a VCS or HTTP
+ * fetch can access. Covers http/https, git@, ssh://, and git:// schemes.
+ * Consolidates the repeated inline URL-detection pattern in source-manage.ts.
+ */
+export function isRemoteUrl(value) {
+    if (!value)
+        return false;
+    return (value.startsWith("http://") ||
+        value.startsWith("https://") ||
+        value.startsWith("git@") ||
+        value.startsWith("ssh://") ||
+        value.startsWith("git://"));
+}
 export function filterNonEmptyStrings(value) {
     if (!Array.isArray(value))
         return undefined;
@@ -18,6 +32,18 @@ export function isAssetType(type) {
     return Object.hasOwn(TYPE_DIRS, type);
 }
 // ── Utilities ───────────────────────────────────────────────────────────────
+/**
+ * Write content to a file atomically via a temp file + rename.
+ * Prevents partial-write corruption on crash.
+ * An optional `mode` (e.g. 0o600) is applied with `chmod` after the rename.
+ */
+export function writeFileAtomic(target, content, mode) {
+    const tmp = `${target}.tmp.${process.pid}.${Math.random().toString(36).slice(2)}`;
+    fs.writeFileSync(tmp, content, "utf8");
+    fs.renameSync(tmp, target);
+    if (mode !== undefined)
+        fs.chmodSync(target, mode);
+}
 /**
  * Resolve the stash directory using a three-level fallback chain:
  *   1. AKM_STASH_DIR environment variable (override for CI/scripts)
@@ -329,3 +355,71 @@ function parseRetryAfter(response) {
 export function toErrorMessage(error) {
     return error instanceof Error ? error.message : String(error);
 }
+// ── Date / timestamp utilities ───────────────────────────────────────────────
+/**
+ * Return today's date in ISO-8601 format (`YYYY-MM-DD`).
+ * Consolidates the `new Date().toISOString().slice(0, 10)` pattern that
+ * appears at multiple call sites.
+ */
+export function todayIso() {
+    return new Date().toISOString().slice(0, 10);
+}
+/**
+ * Return a filesystem-safe timestamp string derived from the current instant.
+ * Colons and dots are replaced with hyphens so the result is safe as a
+ * filename component on all platforms (e.g. `2024-01-15T10-30-00-000Z`).
+ */
+export function timestampForFilename() {
+    return new Date().toISOString().replace(/[:.]/g, "-");
+}
+// ── String coercion ──────────────────────────────────────────────────────────
+/**
+ * Return the trimmed string value if non-empty, otherwise `undefined`.
+ * Consolidates `toStringOrUndefined` (frontmatter.ts), `asNonEmptyString`
+ * (config.ts), and `firstString` (memory-improve.ts) — all had the same
+ * "return a string or undefined" contract with minor semantic differences.
+ */
+export function asNonEmptyString(value) {
+    if (typeof value !== "string")
+        return undefined;
+    const trimmed = value.trim();
+    return trimmed.length > 0 ? trimmed : undefined;
+}
+// ── Generic data utilities ───────────────────────────────────────────────────
+/**
+ * Return the trimmed string if non-empty, otherwise `undefined`.
+ * Equivalent to `firstString` previously defined in `memory-improve.ts`.
+ */
+export function firstString(value) {
+    return typeof value === "string" && value.trim().length > 0 ? value.trim() : undefined;
+}
+/**
+ * Coerce an unknown value to a filtered, trimmed string array.
+ * Non-strings and empty/whitespace-only entries are dropped.
+ */
+export function stringArray(value) {
+    if (!Array.isArray(value))
+        return [];
+    const out = [];
+    for (const item of value) {
+        if (typeof item === "string" && item.trim().length > 0)
+            out.push(item.trim());
+    }
+    return out;
+}
+/**
+ * Group an array of values by a string key derived from each element.
+ * Returns a `Map` so insertion order within each group is preserved.
+ */
+export function groupBy(values, keyFn) {
+    const groups = new Map();
+    for (const value of values) {
+        const key = keyFn(value);
+        const existing = groups.get(key);
+        if (existing)
+            existing.push(value);
+        else
+            groups.set(key, [value]);
+    }
+    return groups;
+}

package/dist/core/concurrent.js

@@ -0,0 +1,22 @@
+/**
+ * Maps over items concurrently with a pool size limit.
+ * Uses Promise.allSettled semantics — one failure does not cancel others.
+ */
+export async function concurrentMap(items, fn, concurrency = 1) {
+    const results = new Array(items.length).fill(undefined);
+    let nextIndex = 0;
+    async function worker() {
+        while (nextIndex < items.length) {
+            const i = nextIndex++;
+            try {
+                results[i] = await fn(items[i], i);
+            }
+            catch {
+                // individual failure: leave undefined, caller checks
+            }
+        }
+    }
+    const workers = Array.from({ length: Math.min(concurrency, items.length) }, worker);
+    await Promise.all(workers);
+    return results;
+}