@ikunin/sprintpilot 1.0.0

package/lib/core/update-check.js

@@ -0,0 +1,39 @@
+'use strict';
+
+const { execFile } = require('node:child_process');
+const semver = require('semver');
+
+const PACKAGE_NAME = '@ikunin/sprintpilot';
+
+function spawnCapture(cmd, args, { timeoutMs = 7000 } = {}) {
+  return new Promise((resolve) => {
+    const child = execFile(cmd, args, { timeout: timeoutMs, windowsHide: true }, (err, stdout) => {
+      if (err) return resolve(null);
+      resolve(String(stdout || '').trim());
+    });
+    child.on('error', () => resolve(null));
+  });
+}
+
+async function fetchLatestVersion() {
+  const out = await spawnCapture('npm', ['view', `${PACKAGE_NAME}@latest`, 'version']);
+  if (!out) return null;
+  const first = out.split(/\r?\n/)[0].trim();
+  return semver.valid(first) ? first : null;
+}
+
+function compareVersions(currentRaw, latestRaw) {
+  if (!currentRaw || !latestRaw) return 'unknown';
+  const current = semver.coerce(currentRaw)?.version || currentRaw;
+  const latest = semver.coerce(latestRaw)?.version || latestRaw;
+  if (!semver.valid(current) || !semver.valid(latest)) return 'unknown';
+  if (semver.gt(latest, current)) return 'behind';
+  if (semver.lt(latest, current)) return 'ahead';
+  return 'current';
+}
+
+module.exports = {
+  PACKAGE_NAME,
+  fetchLatestVersion,
+  compareVersions,
+};

package/lib/core/v1-detect.js

@@ -0,0 +1,86 @@
+'use strict';
+
+const path = require('node:path');
+const fs = require('fs-extra');
+
+const { readYaml } = require('./bmad-config');
+
+const V1_ADDON_DIR_NAME = '_bmad-addons';
+const V1_MANIFEST_NAME = 'bmad-ma-git';
+const V1_SKILL_NAMES = [
+  'bmad-autopilot-on',
+  'bmad-autopilot-off',
+  'bmad-addon-update',
+  'bmad-ma-code-review',
+  'bmad-ma-codebase-map',
+  'bmad-ma-assess',
+  'bmad-ma-reverse-architect',
+  'bmad-ma-migrate',
+  'bmad-ma-research',
+  'bmad-ma-party-mode',
+];
+
+// Returns { v1Dir, v1Manifest, detectedVia, manifestAddonName } if the
+// project at projectRoot looks like a bmad-autopilot-addon v1 install, or
+// null otherwise. A "v1 signature" is either: manifest.yaml with
+// addon.name === 'bmad-ma-git' OR (manifest missing/unreadable/naming a
+// different addon but) a skills/ directory containing at least one
+// v1-named skill dir. A malformed manifest does NOT short-circuit to
+// "not v1" — we fall through to the skill-dir heuristic instead, because
+// partial prior installs frequently leave a corrupt manifest behind.
+//
+// detectedVia distinguishes the trust level:
+//   'manifest'        — authoritative (manifest names bmad-ma-git)
+//   'skills-no-manifest'     — manifest missing, skill-dir heuristic triggered
+//   'skills-unreadable-manifest' — manifest present but unparseable
+//   'skills-other-addon'     — manifest cleanly names a DIFFERENT addon,
+//                              skill dirs still look v1-ish. Ambiguous —
+//                              caller should require explicit confirmation.
+async function detectV1Installation(projectRoot) {
+  const v1Dir = path.join(projectRoot, V1_ADDON_DIR_NAME);
+  if (!(await fs.pathExists(v1Dir))) return null;
+  const v1Manifest = path.join(v1Dir, 'manifest.yaml');
+
+  let isV1 = false;
+  let manifestAddonName = null;
+  let manifestState = 'missing'; // missing | unreadable | parsed
+  if (await fs.pathExists(v1Manifest)) {
+    try {
+      const data = await readYaml(v1Manifest);
+      if (data === null) {
+        manifestState = 'unreadable';
+      } else {
+        manifestState = 'parsed';
+        manifestAddonName = (data && data.addon && data.addon.name) || null;
+        if (manifestAddonName === V1_MANIFEST_NAME) isV1 = true;
+      }
+    } catch {
+      manifestState = 'unreadable';
+    }
+  }
+
+  let detectedVia = isV1 ? 'manifest' : null;
+
+  if (!isV1) {
+    const v1SkillsDir = path.join(v1Dir, 'skills');
+    if (await fs.pathExists(v1SkillsDir)) {
+      const entries = await fs.readdir(v1SkillsDir, { withFileTypes: true });
+      const names = entries.filter((e) => e.isDirectory()).map((e) => e.name);
+      if (names.some((n) => V1_SKILL_NAMES.includes(n))) {
+        isV1 = true;
+        if (manifestState === 'parsed') detectedVia = 'skills-other-addon';
+        else if (manifestState === 'unreadable') detectedVia = 'skills-unreadable-manifest';
+        else detectedVia = 'skills-no-manifest';
+      }
+    }
+  }
+
+  return isV1 ? { v1Dir, v1Manifest, detectedVia, manifestAddonName } : null;
+}
+
+module.exports = {
+  V1_ADDON_DIR_NAME,
+  V1_MANIFEST_NAME,
+  V1_SKILL_NAMES,
+  detectV1Installation,
+};

package/lib/prompts.js

@@ -0,0 +1,82 @@
+'use strict';
+
+let clackPromise;
+
+function loadClack() {
+  if (!clackPromise) {
+    clackPromise = import('@clack/prompts');
+  }
+  return clackPromise;
+}
+
+async function multiselect(opts) {
+  const clack = await loadClack();
+  const result = await clack.multiselect(opts);
+  if (clack.isCancel(result)) {
+    clack.cancel('Cancelled');
+    process.exit(0);
+  }
+  return result;
+}
+
+async function confirm(opts) {
+  const clack = await loadClack();
+  const result = await clack.confirm(opts);
+  if (clack.isCancel(result)) {
+    clack.cancel('Cancelled');
+    process.exit(0);
+  }
+  return result;
+}
+
+async function intro(message) {
+  const clack = await loadClack();
+  clack.intro(message);
+}
+
+async function outro(message) {
+  const clack = await loadClack();
+  clack.outro(message);
+}
+
+async function note(message, title) {
+  const clack = await loadClack();
+  clack.note(message, title);
+}
+
+const log = {
+  async info(message) {
+    const clack = await loadClack();
+    clack.log.info(message);
+  },
+  async success(message) {
+    const clack = await loadClack();
+    clack.log.success(message);
+  },
+  async warn(message) {
+    const clack = await loadClack();
+    clack.log.warn(message);
+  },
+  async error(message) {
+    const clack = await loadClack();
+    clack.log.error(message);
+  },
+  async step(message) {
+    const clack = await loadClack();
+    clack.log.step(message);
+  },
+  async message(message) {
+    const clack = await loadClack();
+    clack.log.message(message);
+  },
+};
+
+module.exports = {
+  loadClack,
+  intro,
+  outro,
+  note,
+  multiselect,
+  confirm,
+  log,
+};

package/lib/substitute.js

@@ -0,0 +1,39 @@
+'use strict';
+
+const path = require('node:path');
+
+const TEXT_EXTENSIONS = new Set([
+  '.md', '.yaml', '.yml', '.json', '.sh', '.txt',
+]);
+
+function isTextFile(filePath) {
+  return TEXT_EXTENSIONS.has(path.extname(filePath).toLowerCase());
+}
+
+function renderString(text, ctx) {
+  if (!text) return text;
+  let out = text;
+  for (const [key, value] of Object.entries(ctx)) {
+    if (value == null) continue;
+    const token = `{${key}}`;
+    if (out.includes(token)) {
+      out = out.split(token).join(value);
+    }
+  }
+  return out;
+}
+
+function buildContext({ outputFolder }) {
+  const out = outputFolder || '_bmad-output';
+  return {
+    output_folder: out,
+    planning_artifacts: `${out}/planning-artifacts`,
+    implementation_artifacts: `${out}/implementation-artifacts`,
+  };
+}
+
+module.exports = {
+  isTextFile,
+  renderString,
+  buildContext,
+};

package/package.json

@@ -0,0 +1,49 @@
+{
+  "name": "@ikunin/sprintpilot",
+  "version": "1.0.0",
+  "description": "Sprintpilot — autopilot and multi-agent addon for BMad Method v6: git workflow, parallel agents, autonomous story execution",
+  "license": "Apache-2.0",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/ikunin/sprintpilot.git"
+  },
+  "homepage": "https://github.com/ikunin/sprintpilot",
+  "bin": {
+    "sprintpilot": "bin/sprintpilot.js"
+  },
+  "files": [
+    "bin/",
+    "lib/",
+    "_Sprintpilot/"
+  ],
+  "keywords": [
+    "sprintpilot",
+    "autopilot",
+    "orchestrator",
+    "ai-development",
+    "claude",
+    "gemini",
+    "cursor",
+    "windsurf",
+    "cline",
+    "git-workflow",
+    "multi-agent",
+    "bmad-method-addon"
+  ],
+  "engines": {
+    "node": ">=18.0.0"
+  },
+  "dependencies": {
+    "@clack/core": "^1.0.0",
+    "@clack/prompts": "^1.0.0",
+    "commander": "^14.0.0",
+    "fs-extra": "^11.3.0",
+    "js-yaml": "^4.1.0",
+    "picocolors": "^1.1.1",
+    "semver": "^7.6.3"
+  },
+  "publishConfig": {
+    "access": "public",
+    "provenance": true
+  }
+}