@open-agent-toolkit/cli 0.1.8 → 0.1.9

package/assets/docs/contributing/hooks-and-safety.md

@@ -14,6 +14,8 @@ The hook distinguishes two states so unmanaged files are not reported the same a
 - **Warning (managed drift or missing):** a manifest-tracked provider entry has drifted or is missing. Emits `oat: managed provider views are out of sync - run 'oat sync --scope project'` to stderr.
 - **Info (unmanaged strays only):** provider files exist inside a managed directory but are not in the manifest. Emits `oat: unmanaged provider files detected - run 'oat status --scope project' to review` to stderr. Not treated as drift.
 
+Gitignored provider files are intentionally skipped by status and hook checks, including entries ignored through `.gitignore`, `.git/info/exclude`, or standard Git exclude configuration.
+
 The hook is non-blocking: it never fails the commit, even when managed drift is detected.
 
 OAT installs the hook into Git's currently active hook directory. When a consumer repo keeps hooks in a repo-managed folder such as `.githooks/`, Git must be configured to use that path before install, or OAT must configure it during the hook prompt flow.

package/assets/docs/provider-sync/manifest-and-drift.md

@@ -51,6 +51,8 @@ Rendered rule files participate in the same drift states as other managed copies
 
 `oat init` and `oat status` can offer adoption of unmanaged provider entries into canonical `.agents`.
 
+Provider files ignored by Git are treated as intentionally local runtime files and are not reported as strays. This includes files covered by tracked `.gitignore`, repo-local `.git/info/exclude`, or other standard Git exclude mechanisms.
+
 For rules, adoption maps provider-native files back into `.agents/rules/*.md`:
 
 - Claude: `.claude/rules/*.md`

package/assets/public-package-versions.json

@@ -1,6 +1,6 @@
 {
-  "cli": "0.1.8",
-  "docs-config": "0.1.8",
-  "docs-theme": "0.1.8",
-  "docs-transforms": "0.1.8"
+  "cli": "0.1.9",
+  "docs-config": "0.1.9",
+  "docs-theme": "0.1.9",
+  "docs-transforms": "0.1.9"
 }

package/dist/drift/strays.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"strays.d.ts","sourceRoot":"","sources":["../../src/drift/strays.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,iBAAiB,CAAC;AAGtD,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,0BAA0B,CAAC;AACzD,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,iCAAiC,CAAC;AAGnE,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AAgBjD,wBAAgB,cAAc,CAAC,WAAW,EAAE,MAAM,GAAG,MAAM,CAoB1D;AAoHD,wBAAsB,YAAY,CAChC,QAAQ,EAAE,MAAM,EAChB,WAAW,EAAE,MAAM,EACnB,QAAQ,EAAE,QAAQ,EAClB,gBAAgB,EAAE,cAAc,EAAE,EAClC,OAAO,CAAC,EAAE,IAAI,CAAC,WAAW,EAAE,aAAa,GAAG,mBAAmB,CAAC,GAC/D,OAAO,CAAC,WAAW,EAAE,CAAC,CAsDxB"}
+{"version":3,"file":"strays.d.ts","sourceRoot":"","sources":["../../src/drift/strays.ts"],"names":[],"mappings":"AAMA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,iBAAiB,CAAC;AAGtD,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,0BAA0B,CAAC;AACzD,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,iCAAiC,CAAC;AAGnE,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AAkBjD,wBAAgB,cAAc,CAAC,WAAW,EAAE,MAAM,GAAG,MAAM,CAoB1D;AAkJD,wBAAsB,YAAY,CAChC,QAAQ,EAAE,MAAM,EAChB,WAAW,EAAE,MAAM,EACnB,QAAQ,EAAE,QAAQ,EAClB,gBAAgB,EAAE,cAAc,EAAE,EAClC,OAAO,CAAC,EAAE,IAAI,CAAC,WAAW,EAAE,aAAa,GAAG,mBAAmB,CAAC,GAC/D,OAAO,CAAC,WAAW,EAAE,CAAC,CA0DxB"}

package/dist/drift/strays.js

@@ -1,9 +1,12 @@
+import { execFile as execFileCallback } from 'node:child_process';
 import { readdir, readFile } from 'node:fs/promises';
 import { basename, join, relative, resolve } from 'node:path';
+import { promisify } from 'node:util';
 import { OAT_MARKER_PREFIX } from '../engine/markers.js';
 import { CliError } from '../errors/index.js';
 import { toPosixPath } from '../fs/paths.js';
 import { canonicalRuleNameForProviderEntry } from '../rules/canonical/index.js';
+const execFile = promisify(execFileCallback);
 function inferContentType(providerDir) {
     const dirName = basename(toPosixPath(providerDir));
     if (dirName === 'skills') {
@@ -110,6 +113,26 @@ async function readProviderEntries(resolvedProviderDir) {
         throw error;
     }
 }
+function isGitExitCode(error, code) {
+    return (typeof error === 'object' &&
+        error !== null &&
+        'code' in error &&
+        Number(error.code) === code);
+}
+async function isGitIgnored(pathRelative, scopeRoot) {
+    try {
+        await execFile('git', ['check-ignore', '--quiet', '--no-index', '--', pathRelative], { cwd: scopeRoot });
+        return true;
+    }
+    catch (error) {
+        // Outside a Git repository, preserve the pre-existing behavior: files that
+        // are not manifest, canonical, or generated entries are still strays.
+        if (isGitExitCode(error, 1) || isGitExitCode(error, 128)) {
+            return false;
+        }
+        throw error;
+    }
+}
 export async function detectStrays(provider, providerDir, manifest, canonicalEntries, mapping) {
     const contentType = mapping?.contentType ?? inferContentType(providerDir);
     const scopeRoot = inferScopeRoot(providerDir);
@@ -131,6 +154,9 @@ export async function detectStrays(provider, providerDir, manifest, canonicalEnt
         if (isManifestTracked(providerPathRelative, manifest)) {
             continue;
         }
+        if (await isGitIgnored(providerPathRelative, scopeRoot)) {
+            continue;
+        }
         if (entry.isFile() &&
             (await isGeneratedAdaptedRule(providerPath, mapping))) {
             continue;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@open-agent-toolkit/cli",
-  "version": "0.1.8",
+  "version": "0.1.9",
   "private": false,
   "description": "Open Agent Toolkit CLI",
   "homepage": "https://github.com/voxmedia/open-agent-toolkit/tree/main/packages/cli",
@@ -33,7 +33,7 @@
     "ora": "^9.0.0",
     "yaml": "2.8.2",
     "zod": "^3.25.76",
-    "@open-agent-toolkit/control-plane": "0.1.8"
+    "@open-agent-toolkit/control-plane": "0.1.9"
   },
   "devDependencies": {
     "@types/node": "^22.10.0",