@oss-autopilot/core 1.9.0 → 1.10.0

package/dist/core/utils.js

@@ -88,6 +88,42 @@ export function getCacheDir() {
     }
     return dir;
 }
+/**
+ * Returns the path to the local Gist ID file (`~/.oss-autopilot/gist-id`).
+ *
+ * This file stores the GitHub Gist ID used by the Gist-based persistence layer,
+ * avoiding a search-by-description API call on every session.
+ *
+ * Implicitly creates the data directory via {@link getDataDir} if it does not exist.
+ *
+ * @returns Absolute path to `gist-id`
+ *
+ * @example
+ * const gistIdPath = getGistIdPath();
+ * // "/Users/you/.oss-autopilot/gist-id"
+ */
+export function getGistIdPath() {
+    const dir = getDataDir();
+    return path.join(dir, 'gist-id');
+}
+/**
+ * Returns the path to the local state cache file (`~/.oss-autopilot/state-cache.json`).
+ *
+ * This file is a write-through cache of the Gist-hosted state, used as a fallback
+ * when the GitHub API is unreachable (degraded mode).
+ *
+ * Implicitly creates the data directory via {@link getDataDir} if it does not exist.
+ *
+ * @returns Absolute path to `state-cache.json`
+ *
+ * @example
+ * const cachePath = getStateCachePath();
+ * // "/Users/you/.oss-autopilot/state-cache.json"
+ */
+export function getStateCachePath() {
+    const dir = getDataDir();
+    return path.join(dir, 'state-cache.json');
+}
 // Validation patterns for GitHub owner and repo names
 const OWNER_PATTERN = /^[a-zA-Z0-9_-]+$/;
 const REPO_PATTERN = /^[a-zA-Z0-9_.-]+$/;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@oss-autopilot/core",
-  "version": "1.9.0",
+  "version": "1.10.0",
   "description": "CLI and core library for managing open source contributions",
   "type": "module",
   "bin": {