agentloopkit 0.24.1 → 0.24.2

package/README.md

@@ -39,18 +39,21 @@ Coding agents often move fast but leave reviewers with weak evidence: unclear sc
 
 ## Install
 
-Use it with `npx` inside an existing repository:
+Use it with `npx` from the root of the repository you want to configure:
 
 ```bash
-npx agentloopkit init
+cd /path/to/your/repo
 npx agentloopkit init --dry-run
+npx agentloopkit init
 ```
 
+`init` writes files into the current directory. Do not run it from `~` unless you intend to configure your home directory. `--dry-run` previews the file changes without writing them.
+
 Pin the current version when you need repeatable CI or team setup:
 
 ```bash
-npx --yes agentloopkit@0.24.1 version
-npx --yes agentloopkit@0.24.1 init
+npx --yes agentloopkit@0.24.2 version
+npx --yes agentloopkit@0.24.2 init
 ```
 
 Run the CLI after install:
@@ -112,6 +115,7 @@ pnpm build
 | --------------------------------------- | ------------------------------------------------------------------------------ |
 | `agentloop init`                        | Generate the repo harness and config                                           |
 | `agentloop init --dry-run`              | Preview generated files without writing them                                   |
+| `agentloop init --force`                | Allow initialization when the current directory is your home directory          |
 | `agentloop doctor`                      | Check setup health, template version, commands, git state, and risk categories |
 | `agentloop create-task`                 | Create a task contract in `.agentloop/tasks/`                                  |
 | `agentloop task list`                   | List task contracts and show the pinned active task                            |
@@ -380,7 +384,7 @@ See `docs/ci-summary.md`.
 ```bash
 agentloop release-notes
 agentloop release-notes --from v0.19.0 --to HEAD
-agentloop release-notes --release-version 0.24.0
+agentloop release-notes --release-version 0.24.2
 agentloop release-notes --json
 agentloop release-notes --write
 ```
@@ -446,7 +450,7 @@ Use `agentloop check-gates --strict` as a review-evidence gate in pull request C
 
 CI-generated verification reports include GitHub Actions provenance when available, so reviewers can trace an artifact back to the workflow run that created it.
 
-See `docs/github-actions.md`, `examples/github-actions/`, `examples/gitlab-ci/`, and `examples/buildkite/` for copy-pasteable workflows. Pin `agentloopkit@0.24.1` or a newer vetted release when reproducibility matters.
+See `docs/github-actions.md`, `examples/github-actions/`, `examples/gitlab-ci/`, and `examples/buildkite/` for copy-pasteable workflows. Pin `agentloopkit@0.24.2` or a newer vetted release when reproducibility matters.
 
 ## PR Summaries
 

package/dist/cli/index.js

@@ -9,6 +9,7 @@ import { Command } from "commander";
 // src/core/init.ts
 import path6 from "path";
 import { readdir as readdir3 } from "fs/promises";
+import { homedir } from "os";
 
 // src/core/constants.ts
 var PACKAGE_NAME = "agentloopkit";
@@ -196,14 +197,20 @@ async function listFilesRecursive(root, options = {}) {
     options.ignore ?? [".git", ".agentloop", "node_modules", "dist", "coverage"]
   );
   const files = [];
-  async function walk(current) {
+  let inspectedEntries = 0;
+  async function walk(current, depth) {
     if (!await pathExists(current)) return;
+    if (options.maxEntries !== void 0 && inspectedEntries >= options.maxEntries) return;
     const entries = await readdir(current, { withFileTypes: true }).catch(() => []);
     for (const entry of entries) {
+      if (options.maxEntries !== void 0 && inspectedEntries >= options.maxEntries) break;
+      inspectedEntries += 1;
       if (ignore.has(entry.name)) continue;
       const absolute = path2.join(current, entry.name);
       if (entry.isDirectory()) {
-        await walk(absolute);
+        if (options.maxDepth === void 0 || depth < options.maxDepth) {
+          await walk(absolute, depth + 1);
+        }
       } else if (entry.isFile()) {
         files.push(absolute);
       }
@@ -211,7 +218,7 @@ async function listFilesRecursive(root, options = {}) {
   }
   const rootStat = await stat(root).catch(() => void 0);
   if (!rootStat?.isDirectory()) return [];
-  await walk(root);
+  await walk(root, 0);
   return files;
 }
 
@@ -247,6 +254,8 @@ var MONOREPO_FILE_MARKERS = [
   "lerna.json",
   "rush.json"
 ];
+var FALLBACK_PROJECT_DETECTION_MAX_DEPTH = 2;
+var FALLBACK_PROJECT_DETECTION_MAX_ENTRIES = 500;
 async function readPackageJson(cwd) {
   const filePath = path4.join(cwd, "package.json");
   if (!await pathExists(filePath)) return void 0;
@@ -267,7 +276,10 @@ async function detectProjectType(cwd) {
   if (await pathExists(path4.join(cwd, "pyproject.toml")) || await pathExists(path4.join(cwd, "requirements.txt"))) {
     return "python";
   }
-  const files = await listFilesRecursive(cwd);
+  const files = await listFilesRecursive(cwd, {
+    maxDepth: FALLBACK_PROJECT_DETECTION_MAX_DEPTH,
+    maxEntries: FALLBACK_PROJECT_DETECTION_MAX_ENTRIES
+  });
   const relativeFiles = files.map((file) => path4.relative(cwd, file));
   const hasCode = relativeFiles.some(
     (file) => /\.(ts|tsx|js|jsx|py|go|rs|java|rb|php|cs)$/.test(file)
@@ -391,6 +403,12 @@ async function initializeAgentLoop(options) {
     dryRun: Boolean(options.dryRun)
   };
   const cwd = options.cwd;
+  const homeDirectory = options.homeDirectory ?? homedir();
+  if (!options.dryRun && !options.force && path6.resolve(cwd) === path6.resolve(homeDirectory)) {
+    throw new Error(
+      "Refusing to initialize your home directory. Run this inside a project repository, or pass --force if you intentionally want AgentLoopKit files in your home directory."
+    );
+  }
   const packageManager = await detectPackageManager(cwd);
   const projectType = await detectProjectType(cwd);
   const projectName = await detectProjectName(cwd);
@@ -473,8 +491,12 @@ var consoleLogger = {
 
 // src/cli/commands/init.ts
 function initCommand() {
-  return new Command("init").description("Initialize AgentLoopKit in the current repository").option("--dry-run", "show planned changes without writing files").option("--json", "print machine-readable output").action(async (options) => {
-    const result = await initializeAgentLoop({ cwd: process.cwd(), dryRun: options.dryRun });
+  return new Command("init").description("Initialize AgentLoopKit in the current repository").option("--dry-run", "show planned changes without writing files").option("--json", "print machine-readable output").option("--force", "allow initialization when the current directory is your home directory").action(async (options) => {
+    const result = await initializeAgentLoop({
+      cwd: process.cwd(),
+      dryRun: options.dryRun,
+      force: options.force
+    });
     if (options.json) {
       consoleLogger.info(JSON.stringify(result, null, 2));
       return;