shakers-cli-beta 0.8.0-beta.0

package/src/saved-positions-client.js

@@ -0,0 +1,71 @@
+'use strict';
+
+// Saved-positions client (hub `works/saved-positions`, talent Bearer). Both
+// operations are idempotent server-side, so no read-before-write is needed.
+
+const { postJsonWithTimeout } = require('./backend-request');
+const { reasonForError } = require('./onboarding-client');
+
+const DEFAULT_TIMEOUT_MS = 20000;
+
+function bearerHeaders(accessToken) {
+  const headers = {};
+  if (typeof accessToken === 'string' && accessToken) headers.Authorization = `Bearer ${accessToken}`;
+  return headers;
+}
+
+async function requestSavePosition({ hubAccessToken } = {}, { positionId, endpoint, timeoutMs = DEFAULT_TIMEOUT_MS } = {}) {
+  if (!endpoint) return { ok: false, reason: 'no-endpoint' };
+  if (!positionId) return { ok: false, reason: 'no-id' };
+  if (!hubAccessToken) return { ok: false, reason: 'no-hub-token' };
+  let res;
+  try {
+    res = await postJsonWithTimeout(endpoint, { positionId }, timeoutMs, 'POST', null, bearerHeaders(hubAccessToken));
+  } catch (e) {
+    return { ok: false, reason: (e && e.kind) || 'network-error' };
+  }
+  if (res.status === 404) return { ok: false, reason: 'not-found' };
+  if (res.status < 200 || res.status >= 300) return { ok: false, reason: reasonForError(res.status, res.raw) };
+  return { ok: true };
+}
+
+async function requestUnsavePosition({ hubAccessToken } = {}, { positionId, endpoint, timeoutMs = DEFAULT_TIMEOUT_MS } = {}) {
+  if (!endpoint) return { ok: false, reason: 'no-endpoint' };
+  if (!positionId) return { ok: false, reason: 'no-id' };
+  if (!hubAccessToken) return { ok: false, reason: 'no-hub-token' };
+  let res;
+  try {
+    res = await postJsonWithTimeout(endpoint, null, timeoutMs, 'DELETE', null, bearerHeaders(hubAccessToken));
+  } catch (e) {
+    return { ok: false, reason: (e && e.kind) || 'network-error' };
+  }
+  if (res.status < 200 || res.status >= 300) return { ok: false, reason: reasonForError(res.status, res.raw) };
+  return { ok: true };
+}
+
+async function savePosition(deps = {}, { hubAccessToken, positionId, timeoutMs = DEFAULT_TIMEOUT_MS } = {}) {
+  const {
+    getSavePositionEndpoint = require('./config').getSavePositionEndpoint,
+    requestSavePosition: request = requestSavePosition,
+  } = deps;
+  const endpoint = getSavePositionEndpoint();
+  if (!endpoint) return { ok: false, reason: 'no-endpoint' };
+  return request({ hubAccessToken }, { positionId, endpoint, timeoutMs });
+}
+
+async function unsavePosition(deps = {}, { hubAccessToken, positionId, timeoutMs = DEFAULT_TIMEOUT_MS } = {}) {
+  const {
+    getUnsavePositionEndpoint = require('./config').getUnsavePositionEndpoint,
+    requestUnsavePosition: request = requestUnsavePosition,
+  } = deps;
+  const endpoint = getUnsavePositionEndpoint(positionId);
+  if (!endpoint) return { ok: false, reason: positionId ? 'no-endpoint' : 'no-id' };
+  return request({ hubAccessToken }, { positionId, endpoint, timeoutMs });
+}
+
+module.exports = {
+  requestSavePosition,
+  requestUnsavePosition,
+  savePosition,
+  unsavePosition,
+};

package/src/saved-positions-flow.js

@@ -0,0 +1,50 @@
+'use strict';
+
+// `save` / `unsave` flows: bookmark a Position. Reversible + idempotent, so no
+// confirmation (owner: low risk). Talent Bearer.
+
+function makeSavedPositionsDeps(overrides = {}) {
+  const client = require('./saved-positions-client');
+  return {
+    savePosition: (opts) => client.savePosition({}, opts),
+    unsavePosition: (opts) => client.unsavePosition({}, opts),
+    resolveRef: (raw) => require('./find-projects-cache').resolvePositionRef(raw),
+    ...overrides,
+  };
+}
+
+async function runToggleSave({ io, rawOut, session, catalog, mode, opts = {}, deps = makeSavedPositionsDeps() }) {
+  const fp = catalog.savedPositions;
+  const hubAccessToken = session ? session.hubAccessToken : null;
+  // A pure integer resolves against the last `find-projects` listing; a UUID/Mongo id passes through.
+  const resolved = deps.resolveRef(opts.id);
+  if (!resolved.ok) {
+    const idRequired = mode === 'save' ? fp.saveIdRequired : fp.unsaveIdRequired;
+    io.error(resolved.reason === 'no-cache' ? fp.refNoCache
+      : resolved.reason === 'out-of-range' ? fp.refOutOfRange(resolved.count)
+        : idRequired);
+    return { ok: false, reason: resolved.reason };
+  }
+  const positionId = resolved.id;
+
+  const label = mode === 'save' ? fp.saving : fp.unsaving;
+  const res = await io.withProgress(label, () => (mode === 'save'
+    ? deps.savePosition({ hubAccessToken, positionId })
+    : deps.unsavePosition({ hubAccessToken, positionId })));
+  if (!res.ok) {
+    io.error(res.reason === 'not-found' ? fp.notFound : fp.failed(res.reason));
+    return { ok: false, reason: res.reason };
+  }
+
+  if (opts.json) {
+    (rawOut || ((s) => process.stdout.write(s)))(`${JSON.stringify({ ok: true, mode, positionId }, null, 2)}\n`);
+    return { ok: true };
+  }
+  io.success(mode === 'save' ? fp.saved : fp.unsaved);
+  return { ok: true };
+}
+
+module.exports = {
+  makeSavedPositionsDeps,
+  runToggleSave,
+};

package/src/scan-exclusions.js

@@ -0,0 +1,50 @@
+'use strict';
+
+const path = require('path');
+
+// Directory names never descended into when walking a project tree (skill-code-certification, issue 008).
+const EXCLUDED_DIRS = new Set([
+  'node_modules', 'dist', 'build', '.git', 'vendor', 'coverage', '.next', 'out',
+  // Python
+  '__pycache__', '.venv', 'venv', '.tox', '.mypy_cache', '.pytest_cache', '.eggs',
+  // Ruby
+  '.bundle',
+  // Java / JVM (Gradle/Maven build output)
+  'target', '.gradle',
+]);
+
+const MAX_WALK_DEPTH = 8;
+
+const SYSTEM_ROOT_PATHS = new Set([
+  '/System', '/Library', '/Volumes', '/private', '/dev', '/proc',
+  '/opt', '/Applications', '/usr', '/bin', '/sbin', '/etc', '/var',
+  '/cores', '/Network',
+]);
+
+function normalizeWalkRoot(root) {
+  const resolved = path.resolve(root);
+  return resolved.length > 1 ? resolved.replace(/\/+$/, '') : resolved;
+}
+
+function isRefusedWalkRoot(root) {
+  if (typeof root !== 'string' || !root) return true;
+  let norm;
+  try {
+    norm = normalizeWalkRoot(root);
+  } catch {
+    return true;
+  }
+  return norm === '/' || SYSTEM_ROOT_PATHS.has(norm);
+}
+
+function isExcludedWalkPath(absDir) {
+  return SYSTEM_ROOT_PATHS.has(absDir);
+}
+
+module.exports = {
+  EXCLUDED_DIRS,
+  MAX_WALK_DEPTH,
+  SYSTEM_ROOT_PATHS,
+  isRefusedWalkRoot,
+  isExcludedWalkPath,
+};