@dadado/agent-kit-cli 5.15.1 → 5.16.0

package/dist/chunk-5OXPNVCF.js

@@ -0,0 +1,106 @@
+import {
+  L0_ARTIFACTS
+} from "./chunk-6QV2BFGA.js";
+import {
+  copyRegistryFile,
+  emptyStats,
+  installPack,
+  installSkillsByIds,
+  loadManagedHashLedger,
+  loadRegistry,
+  mergeStats,
+  recordOutcome,
+  resolveProtectedGlobs,
+  saveManagedHashLedger
+} from "./chunk-VS2JD2XC.js";
+import {
+  fileExists
+} from "./chunk-77V75A7O.js";
+
+// src/lifecycle/onboard-migration.ts
+import { createHash } from "crypto";
+import { readFile, unlink } from "fs/promises";
+import path from "path";
+var LEGACY_ONBOARD_PATH = ".cursor/commands/onboard.md";
+var NAMESPACED_ONBOARD_PATH = ".cursor/commands/agent-kit-onboard.md";
+var MANAGED_LEGACY_HASHES = /* @__PURE__ */ new Set([
+  "b274a68941813f19b185893cb7c5561dff027f53270890029992f208e24992fe"
+]);
+async function migrateLegacyOnboardCommand(projectRoot, managedHashes = MANAGED_LEGACY_HASHES) {
+  const legacyPath = path.join(projectRoot, LEGACY_ONBOARD_PATH);
+  if (!await fileExists(legacyPath)) return "absent";
+  const namespacedPath = path.join(projectRoot, NAMESPACED_ONBOARD_PATH);
+  if (!await fileExists(namespacedPath)) return "preserved-customized";
+  const content = await readFile(legacyPath);
+  const hash = createHash("sha256").update(content).digest("hex");
+  if (!managedHashes.has(hash)) return "preserved-customized";
+  await unlink(legacyPath);
+  return "removed-managed";
+}
+
+// src/lifecycle/sync.ts
+async function installL0(registryRoot, projectRoot, protectedGlobs, ledger) {
+  const stats = emptyStats();
+  const managedHashes = ledger ?? await loadManagedHashLedger(projectRoot);
+  const copyOpts = { managedHashes, persistManagedHashes: false };
+  for (const artifact of L0_ARTIFACTS) {
+    const outcome = await copyRegistryFile(
+      registryRoot,
+      projectRoot,
+      artifact.source,
+      artifact.target,
+      protectedGlobs,
+      copyOpts
+    );
+    recordOutcome(stats, artifact.target, outcome);
+  }
+  if (!ledger) await saveManagedHashLedger(projectRoot, managedHashes);
+  const migration = await migrateLegacyOnboardCommand(projectRoot);
+  if (migration === "removed-managed") {
+    stats.removed.push(".cursor/commands/onboard.md");
+  } else if (migration === "preserved-customized") {
+    stats.collisions.push(".cursor/commands/onboard.md");
+  }
+  return stats;
+}
+async function syncFromManifest(registryRoot, projectRoot, manifest) {
+  const protectedGlobs = resolveProtectedGlobs(manifest);
+  const stats = emptyStats();
+  const managedHashes = await loadManagedHashLedger(projectRoot);
+  const installOpts = { protectedGlobs, managedHashes };
+  try {
+    mergeStats(stats, await installL0(registryRoot, projectRoot, protectedGlobs, managedHashes));
+    for (const packId of manifest.packs ?? []) {
+      mergeStats(stats, await installPack(registryRoot, projectRoot, packId, installOpts));
+    }
+    const skillIds = manifest.skills ?? [];
+    if (skillIds.length > 0) {
+      await loadRegistry(registryRoot);
+      mergeStats(stats, await installSkillsByIds(registryRoot, projectRoot, skillIds, installOpts));
+    }
+  } finally {
+    await saveManagedHashLedger(projectRoot, managedHashes);
+  }
+  return stats;
+}
+
+// src/commands/shared-args.ts
+var NON_INTERACTIVE_ROOT_ARGS = {
+  yes: {
+    type: "boolean",
+    alias: "y",
+    description: "Skip interactive prompts; use defaults (IDE-agnostic non-interactive mode)",
+    default: false
+  },
+  "force-root": {
+    type: "boolean",
+    description: "Bypass the ambiguous-root guard (use with caution)",
+    default: false
+  }
+};
+
+export {
+  installL0,
+  syncFromManifest,
+  NON_INTERACTIVE_ROOT_ARGS
+};

package/dist/chunk-5VCOWTTP.js

@@ -0,0 +1,6 @@
+// src/utils/kit-paths.ts
+var HANDOFF_REL = ".cursor/HANDOFF.md";
+
+export {
+  HANDOFF_REL
+};

package/dist/chunk-6QV2BFGA.js

@@ -0,0 +1,341 @@
+import {
+  allSkills,
+  loadPackManifest,
+  loadRegistry,
+  packMemberFileTargets,
+  skillFileTargets
+} from "./chunk-VS2JD2XC.js";
+
+// src/lifecycle/l0.ts
+var L0_ARTIFACTS = [
+  // Rules
+  {
+    source: ".cursor/rules/cursor-plan-handoff.mdc",
+    target: ".cursor/rules/cursor-plan-handoff.mdc"
+  },
+  {
+    source: ".cursor/rules/context-guardian.mdc",
+    target: ".cursor/rules/context-guardian.mdc"
+  },
+  {
+    source: ".cursor/rules/cursor-skills-git-workflow.mdc",
+    target: ".cursor/rules/cursor-skills-git-workflow.mdc"
+  },
+  {
+    source: ".cursor/rules/cursor-skills-general.mdc",
+    target: ".cursor/rules/cursor-skills-general.mdc"
+  },
+  { source: ".cursor/rules/ux-tone.mdc", target: ".cursor/rules/ux-tone.mdc" },
+  {
+    source: ".cursor/rules/agent-output-hygiene.mdc",
+    target: ".cursor/rules/agent-output-hygiene.mdc"
+  },
+  {
+    source: ".cursor/rules/docs-professional-standard.mdc",
+    target: ".cursor/rules/docs-professional-standard.mdc"
+  },
+  { source: ".cursor/rules/memory-loop.mdc", target: ".cursor/rules/memory-loop.mdc" },
+  {
+    source: ".cursor/rules/hitl-ask-questions.mdc",
+    target: ".cursor/rules/hitl-ask-questions.mdc"
+  },
+  {
+    source: ".cursor/skills/core/hitl-gates/SKILL.md",
+    target: ".cursor/skills/core/hitl-gates/SKILL.md"
+  },
+  {
+    source: ".cursor/skills/core/hitl-gates/procedures.md",
+    target: ".cursor/skills/core/hitl-gates/procedures.md"
+  },
+  {
+    source: ".cursor/skills/core/hitl-gates/run-plan-tick-contract.md",
+    target: ".cursor/skills/core/hitl-gates/run-plan-tick-contract.md"
+  },
+  {
+    source: ".cursor/skills/core/hitl-gates/start-project-intake.md",
+    target: ".cursor/skills/core/hitl-gates/start-project-intake.md"
+  },
+  {
+    source: ".cursor/skills/core/hitl-gates/run-plan-all-queue.md",
+    target: ".cursor/skills/core/hitl-gates/run-plan-all-queue.md"
+  },
+  {
+    source: ".cursor/skills/core/qa/SKILL.md",
+    target: ".cursor/skills/core/qa/SKILL.md"
+  },
+  {
+    source: ".cursor/skills/core/dashboard-broadcast/SKILL.md",
+    target: ".cursor/skills/core/dashboard-broadcast/SKILL.md"
+  },
+  {
+    source: ".cursor/skills/core/plan-review-triage/procedure.md",
+    target: ".cursor/skills/core/plan-review-triage/procedure.md"
+  },
+  {
+    source: ".cursor/skills/core/plan-external-review/procedure.md",
+    target: ".cursor/skills/core/plan-external-review/procedure.md"
+  },
+  {
+    source: ".cursor/skills/core/agent-kit-onboard/procedure.md",
+    target: ".cursor/skills/core/agent-kit-onboard/procedure.md"
+  },
+  {
+    source: ".cursor/skills/core/field-report-resolve/procedure.md",
+    target: ".cursor/skills/core/field-report-resolve/procedure.md"
+  },
+  {
+    source: ".cursor/skills/core/backlog-add/procedure.md",
+    target: ".cursor/skills/core/backlog-add/procedure.md"
+  },
+  {
+    source: "registry/rules/git-secrets-safety.mdc",
+    target: ".cursor/rules/git-secrets-safety.mdc"
+  },
+  // Commands
+  {
+    source: ".cursor/commands/start-project.md",
+    target: ".cursor/commands/start-project.md"
+  },
+  {
+    source: ".cursor/commands/backlog-add.md",
+    target: ".cursor/commands/backlog-add.md"
+  },
+  {
+    source: ".cursor/commands/backlog-edit.md",
+    target: ".cursor/commands/backlog-edit.md"
+  },
+  {
+    source: ".cursor/commands/backlog-delete.md",
+    target: ".cursor/commands/backlog-delete.md"
+  },
+  {
+    source: ".cursor/commands/backlog-cancel.md",
+    target: ".cursor/commands/backlog-cancel.md"
+  },
+  {
+    source: ".cursor/commands/archive-plan.md",
+    target: ".cursor/commands/archive-plan.md"
+  },
+  {
+    source: ".cursor/commands/agent-kit-onboard.md",
+    target: ".cursor/commands/agent-kit-onboard.md"
+  },
+  {
+    source: ".cursor/commands/continue-plan.md",
+    target: ".cursor/commands/continue-plan.md"
+  },
+  {
+    source: ".cursor/commands/run-plan.md",
+    target: ".cursor/commands/run-plan.md"
+  },
+  {
+    source: ".cursor/commands/hotfix.md",
+    target: ".cursor/commands/hotfix.md"
+  },
+  {
+    source: ".cursor/commands/run-plan-all.md",
+    target: ".cursor/commands/run-plan-all.md"
+  },
+  // Deprecated aliases of /run-plan (kept so existing references keep working)
+  {
+    source: ".cursor/commands/run-plan-loop.md",
+    target: ".cursor/commands/run-plan-loop.md"
+  },
+  {
+    source: ".cursor/commands/run-plan-orchestrated.md",
+    target: ".cursor/commands/run-plan-orchestrated.md"
+  },
+  { source: ".cursor/commands/handoff.md", target: ".cursor/commands/handoff.md" },
+  { source: ".cursor/commands/summary.md", target: ".cursor/commands/summary.md" },
+  {
+    source: ".cursor/commands/dashboard.md",
+    target: ".cursor/commands/dashboard.md"
+  },
+  {
+    source: ".cursor/commands/dashboard-broadcast.md",
+    target: ".cursor/commands/dashboard-broadcast.md"
+  },
+  {
+    source: ".cursor/commands/git-staging.md",
+    target: ".cursor/commands/git-staging.md"
+  },
+  { source: ".cursor/commands/git-prod.md", target: ".cursor/commands/git-prod.md" },
+  // Factory landing wraps: keep `.cursor/commands/kit-staging.md` and
+  // `kit-prod.md` on disk. They are not consumer L0 (surface diet).
+  {
+    source: ".cursor/commands/plan-external-review.md",
+    target: ".cursor/commands/plan-external-review.md"
+  },
+  {
+    source: ".cursor/commands/plan-review-triage.md",
+    target: ".cursor/commands/plan-review-triage.md"
+  },
+  {
+    source: ".cursor/commands/field-report-resolve.md",
+    target: ".cursor/commands/field-report-resolve.md"
+  },
+  {
+    source: ".cursor/commands/dogfood.md",
+    target: ".cursor/commands/dogfood.md"
+  },
+  // Factory-only: `.cursor/commands/public-issue-triage.md` and
+  // `.cursor/commands/public-inbound-radar.md` are intentionally omitted from
+  // L0 (and excluded from public-sync). See ADRs
+  // 2026-08-05_factory-only-public-issue-triage-command.md and
+  // 2026-09-24_public-inbound-radar.md.
+  {
+    source: ".cursor/commands/cursor-update-awareness.md",
+    target: ".cursor/commands/cursor-update-awareness.md"
+  },
+  {
+    source: ".cursor/commands/qa.md",
+    target: ".cursor/commands/qa.md"
+  },
+  {
+    source: ".cursor/commands/update.md",
+    target: ".cursor/commands/update.md"
+  },
+  // Context (templates + example config; private config.json is not L0)
+  {
+    source: ".cursor/context/templates/plan-external-review-prompt.md",
+    target: ".cursor/context/templates/plan-external-review-prompt.md"
+  },
+  {
+    source: ".cursor/context/templates/plan.md",
+    target: ".cursor/context/templates/plan.md"
+  },
+  {
+    source: ".cursor/context/templates/context-pack.md",
+    target: ".cursor/context/templates/context-pack.md"
+  },
+  {
+    source: ".cursor/context/templates/task-brief.md",
+    target: ".cursor/context/templates/task-brief.md"
+  },
+  {
+    source: ".cursor/context/templates/handoff.md",
+    target: ".cursor/context/templates/handoff.md"
+  },
+  {
+    source: ".cursor/context/templates/adr.md",
+    target: ".cursor/context/templates/adr.md"
+  },
+  {
+    source: ".cursor/context/templates/plan-monitor.md",
+    target: ".cursor/context/templates/plan-monitor.md"
+  },
+  {
+    source: ".cursor/context/templates/memory-entry.md",
+    target: ".cursor/context/templates/memory-entry.md"
+  },
+  {
+    source: ".cursor/context/config.example.json",
+    target: ".cursor/context/config.example.json"
+  },
+  // Scripts (canonical launchers; consumers never receive repo-root scripts/)
+  {
+    source: ".cursor/scripts/plan-external-review.sh",
+    target: ".cursor/scripts/plan-external-review.sh"
+  },
+  {
+    source: ".cursor/scripts/field-report-cadence-bump.sh",
+    target: ".cursor/scripts/field-report-cadence-bump.sh"
+  },
+  {
+    source: ".cursor/scripts/run-plan-all-consolidate.sh",
+    target: ".cursor/scripts/run-plan-all-consolidate.sh"
+  },
+  // Secrets gate (structural)
+  {
+    source: ".cursor/hooks/pre-commit/check-secrets.sh",
+    target: ".cursor/hooks/pre-commit/check-secrets.sh"
+  },
+  // Native Cursor agent hooks (thin adapters -> agent-kit CLI)
+  {
+    source: ".cursor/hooks.json",
+    target: ".cursor/hooks.json"
+  },
+  {
+    source: ".cursor/hooks/agent/resolve-agent-kit.sh",
+    target: ".cursor/hooks/agent/resolve-agent-kit.sh"
+  },
+  {
+    source: ".cursor/hooks/agent/session-start.sh",
+    target: ".cursor/hooks/agent/session-start.sh"
+  },
+  {
+    source: ".cursor/hooks/agent/pre-compact.sh",
+    target: ".cursor/hooks/agent/pre-compact.sh"
+  },
+  {
+    source: ".cursor/hooks/agent/guard-shell.sh",
+    target: ".cursor/hooks/agent/guard-shell.sh"
+  },
+  {
+    source: ".cursor/hooks/agent/after-edit-schema.sh",
+    target: ".cursor/hooks/agent/after-edit-schema.sh"
+  },
+  {
+    source: ".cursor/hooks/agent/secrets-prompt.sh",
+    target: ".cursor/hooks/agent/secrets-prompt.sh"
+  },
+  // Git spine docs at project root (not a nested agent-kit/ copy)
+  {
+    source: "autogit/gitupdate.md",
+    target: "autogit/gitupdate.md"
+  },
+  {
+    source: "autogit/plan-routine.md",
+    target: "autogit/plan-routine.md"
+  },
+  // Signature gate script: the staging/prod routines run
+  // `sh git-hooks/prepare-commit-msg --check -`, so the file must exist in the
+  // checkout. Installing it into .git/hooks stays optional (issue #89).
+  {
+    source: "git-hooks/prepare-commit-msg",
+    target: "git-hooks/prepare-commit-msg"
+  }
+];
+
+// src/lifecycle/targets.ts
+import path from "path";
+var toPosix = (rel) => rel.split(path.sep).join("/");
+async function managedPairs(registryRoot, manifest, index) {
+  const pairs = [];
+  const missingSkills = [];
+  const push = (sourceRel, targetRel, origin) => {
+    pairs.push({ sourceRel: toPosix(sourceRel), targetRel: toPosix(targetRel), origin });
+  };
+  for (const a of L0_ARTIFACTS) push(a.source, a.target, "l0");
+  for (const packId of manifest.packs ?? []) {
+    const pack = await loadPackManifest(registryRoot, packId);
+    for (const member of pack.members) {
+      for (const { sourceRel, targetRel } of await packMemberFileTargets(registryRoot, member)) {
+        push(sourceRel, targetRel, "pack");
+      }
+    }
+  }
+  if ((manifest.skills ?? []).length > 0) {
+    const pool = allSkills(index ?? await loadRegistry(registryRoot));
+    for (const id of manifest.skills ?? []) {
+      const skill = pool.find((s) => s.id === id);
+      if (!skill) {
+        missingSkills.push(id);
+        continue;
+      }
+      for (const { sourceRel, targetRel } of await skillFileTargets(
+        registryRoot,
+        skill.path,
+        skill.id
+      )) {
+        push(sourceRel, targetRel, "skill");
+      }
+    }
+  }
+  return { pairs, missingSkills };
+}
+
+export {
+  L0_ARTIFACTS,
+  managedPairs
+};

package/dist/chunk-77V75A7O.js

@@ -0,0 +1,39 @@
+// src/utils/fs.ts
+import { randomUUID } from "crypto";
+import { constants } from "fs";
+import { access, mkdir, readFile, readdir, rename, writeFile } from "fs/promises";
+import path from "path";
+async function fileExists(target) {
+  try {
+    await access(target, constants.F_OK);
+    return true;
+  } catch {
+    return false;
+  }
+}
+async function readJson(target) {
+  if (!await fileExists(target)) return null;
+  const raw = await readFile(target, "utf8");
+  return JSON.parse(raw);
+}
+async function writeJson(target, data) {
+  await ensureDir(path.dirname(target));
+  const tmp = `${target}.${randomUUID()}.tmp`;
+  await writeFile(tmp, `${JSON.stringify(data, null, 2)}
+`, "utf8");
+  await rename(tmp, target);
+}
+async function ensureDir(target) {
+  await mkdir(target, { recursive: true });
+}
+async function listDirectory(rootDir) {
+  return readdir(rootDir);
+}
+
+export {
+  fileExists,
+  readJson,
+  writeJson,
+  ensureDir,
+  listDirectory
+};

package/dist/chunk-7HDQEK6T.js

@@ -0,0 +1,26 @@
+// src/lifecycle/version.ts
+import { createRequire } from "module";
+var require2 = createRequire(import.meta.url);
+function loadPackageVersion() {
+  for (const packagePath of ["../package.json", "../../package.json"]) {
+    try {
+      const metadata = require2(packagePath);
+      if (typeof metadata.version === "string" && metadata.version.length > 0) {
+        return metadata.version;
+      }
+    } catch {
+    }
+  }
+  throw new Error("Unable to resolve the Agent Kit CLI package version");
+}
+var KIT_VERSION = loadPackageVersion();
+var KIT_PACKAGE_SPEC = "@dadado/agent-kit-cli";
+function pinnedCliSpec(version = KIT_VERSION) {
+  return `${KIT_PACKAGE_SPEC}@${version}`;
+}
+
+export {
+  KIT_VERSION,
+  KIT_PACKAGE_SPEC,
+  pinnedCliSpec
+};