{"_id":"@a16njs/plugin-agentsmd","_rev":"6-3eca8b9ed4719033d78e26c564c3d03d","name":"@a16njs/plugin-agentsmd","dist-tags":{"latest":"1.1.0"},"versions":{"1.0.1":{"name":"@a16njs/plugin-agentsmd","version":"1.0.1","author":{"name":"Texarkanine"},"license":"AGPL-3.0","_id":"@a16njs/plugin-agentsmd@1.0.1","maintainers":[{"name":"texarkanine","email":"texarkanine@protonmail.com"}],"homepage":"https://texarkanine.github.io/a16n/plugin-agentsmd","bugs":{"url":"https://github.com/Texarkanine/a16n/issues"},"dist":{"shasum":"1ef6bfdf83b9edd53112ee1ea2e75ec4496150f2","tarball":"https://registry.npmjs.org/@a16njs/plugin-agentsmd/-/plugin-agentsmd-1.0.1.tgz","fileCount":14,"integrity":"sha512-J/COriX6acy5kZTOolGodYIU6nMazyuhh8N2RqCooui35pqQnRCWhc3XauuFjBt4BYwBbF5+CP4XbUsXc0Aryw==","signatures":[{"sig":"MEQCIFZE9ol97nVA7B/afn7Hq9vlIdwf3kgF6/I0z51rDseTAiBO/Yv6BzRrCoOslLHQunnPQZ7UB0mHwOxf9KuHk4sy/Q==","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":29127},"main":"./dist/index.js","type":"module","types":"./dist/index.d.ts","engines":{"node":">=22.0.0"},"exports":{".":{"types":"./dist/index.d.ts","import":"./dist/index.js"}},"gitHead":"e936eb6934e41bfe9f4ad3634c4bf7858e49988f","scripts":{"test":"vitest run","build":"tsc","clean":"rimraf dist *.tsbuildinfo","typecheck":"tsc --noEmit","test:watch":"vitest","test:coverage":"vitest run --coverage"},"_npmUser":{"name":"texarkanine","email":"texarkanine@protonmail.com"},"deprecated":"Broken publish (workspace:* deps). Use 1.0.3+.","repository":{"url":"git+https://github.com/Texarkanine/a16n.git","type":"git","directory":"packages/plugin-agentsmd"},"_npmVersion":"11.12.1","description":"AGENTS.md plugin for a16n","directories":{},"_nodeVersion":"22.22.1","dependencies":{"@a16njs/models":"workspace:*"},"publishConfig":{"access":"public"},"_hasShrinkwrap":false,"devDependencies":{"vitest":"^2.0.0","typescript":"^5.4.0","@types/node":"^25.9.3"},"_npmOperationalInternal":{"tmp":"tmp/plugin-agentsmd_1.0.1_1781298650785_0.9161985283223872","host":"s3://npm-registry-packages-npm-production"}},"1.0.2":{"name":"@a16njs/plugin-agentsmd","version":"1.0.2","author":{"name":"Texarkanine"},"license":"AGPL-3.0","_id":"@a16njs/plugin-agentsmd@1.0.2","maintainers":[{"name":"texarkanine","email":"texarkanine@protonmail.com"}],"homepage":"https://texarkanine.github.io/a16n/plugin-agentsmd","bugs":{"url":"https://github.com/Texarkanine/a16n/issues"},"dist":{"shasum":"bf3e498152d92e5976fadc6ad6db2eb9365966aa","tarball":"https://registry.npmjs.org/@a16njs/plugin-agentsmd/-/plugin-agentsmd-1.0.2.tgz","fileCount":14,"integrity":"sha512-iF+lmpjwy/UqCoJ2MNdmyeLWeg22vjSlOttIV6BzYspHD3iYIPAajUR76ibaRoH75Qec8rIieQLmAgWcp8Lmqg==","signatures":[{"sig":"MEQCIEMLeAthQZhd+RKz0jUNYYNiM1c8/ipqg6aIO/4CK5eSAiBplJNUjn1QXJgrqEIiRVa48JUef0UuWFbGNF72IVcZWA==","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":29127},"main":"./dist/index.js","type":"module","types":"./dist/index.d.ts","engines":{"node":">=22.0.0"},"exports":{".":{"types":"./dist/index.d.ts","import":"./dist/index.js"}},"gitHead":"c42ffec6a2c20df35f2dbb30565bdf1a0289f4bd","scripts":{"test":"vitest run","build":"tsc","clean":"rimraf dist *.tsbuildinfo","typecheck":"tsc --noEmit","test:watch":"vitest","test:coverage":"vitest run --coverage"},"_npmUser":{"name":"texarkanine","email":"texarkanine@protonmail.com"},"deprecated":"Broken publish (workspace:* deps). Use 1.0.3+.","repository":{"url":"git+https://github.com/Texarkanine/a16n.git","type":"git","directory":"packages/plugin-agentsmd"},"_npmVersion":"11.12.1","description":"AGENTS.md plugin for a16n","directories":{},"_nodeVersion":"22.22.1","dependencies":{"@a16njs/models":"workspace:*"},"publishConfig":{"access":"public"},"_hasShrinkwrap":false,"devDependencies":{"vitest":"^3.2.6","typescript":"^6.0.3","@types/node":"^25.9.3"},"_npmOperationalInternal":{"tmp":"tmp/plugin-agentsmd_1.0.2_1781381565631_0.212003485992186","host":"s3://npm-registry-packages-npm-production"}},"1.0.3":{"name":"@a16njs/plugin-agentsmd","version":"1.0.3","author":{"name":"Texarkanine"},"license":"AGPL-3.0","_id":"@a16njs/plugin-agentsmd@1.0.3","maintainers":[{"name":"texarkanine","email":"texarkanine@protonmail.com"}],"homepage":"https://texarkanine.github.io/a16n/plugin-agentsmd","bugs":{"url":"https://github.com/Texarkanine/a16n/issues"},"dist":{"shasum":"79faf120e0d56429ec2c60ee6a51054ed9092570","tarball":"https://registry.npmjs.org/@a16njs/plugin-agentsmd/-/plugin-agentsmd-1.0.3.tgz","fileCount":15,"integrity":"sha512-V5YfgpN8gLwnSbAyD92ZZzqtopH0tcH2u2TS6zRMDyzJbqlVj0ZzcOjLQMi6BnBCpP4fE2h4Z3UujG0tPdGBNg==","signatures":[{"sig":"MEUCIQDYvsuMNJ2Bn20isT7hsSlyrtS40CxEVMgMlxscfaoD5QIgM6ZibCjdQPHK8dUyvpsSiJgd31Ik9nDKBXfz++tQPDo=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"attestations":{"url":"https://registry.npmjs.org/-/npm/v1/attestations/@a16njs%2fplugin-agentsmd@1.0.3","provenance":{"predicateType":"https://slsa.dev/provenance/v1"}},"unpackedSize":63644},"main":"./dist/index.js","type":"module","_from":"file:a16njs-plugin-agentsmd-1.0.3.tgz","types":"./dist/index.d.ts","engines":{"node":">=22.0.0"},"exports":{".":{"types":"./dist/index.d.ts","import":"./dist/index.js"}},"scripts":{"test":"vitest run","build":"tsc","clean":"rimraf dist *.tsbuildinfo","typecheck":"tsc --noEmit","test:watch":"vitest","test:coverage":"vitest run --coverage"},"_npmUser":{"name":"GitHub Actions","email":"npm-oidc-no-reply@github.com","trustedPublisher":{"id":"github","oidcConfigId":"oidc:b84be6a6-537e-4aa1-8ce8-af58a4f49c22"}},"_resolved":"/tmp/206d9013dead5dbdda9f734f55bdeb6d/a16njs-plugin-agentsmd-1.0.3.tgz","_integrity":"sha512-V5YfgpN8gLwnSbAyD92ZZzqtopH0tcH2u2TS6zRMDyzJbqlVj0ZzcOjLQMi6BnBCpP4fE2h4Z3UujG0tPdGBNg==","repository":{"url":"git+https://github.com/Texarkanine/a16n.git","type":"git","directory":"packages/plugin-agentsmd"},"_npmVersion":"11.5.1","description":"AGENTS.md plugin for a16n","directories":{},"_nodeVersion":"22.22.1","dependencies":{"@a16njs/models":"0.14.1"},"publishConfig":{"access":"public"},"_hasShrinkwrap":false,"devDependencies":{"vitest":"^3.2.6","typescript":"^6.0.3","@types/node":"^25.9.3"},"_npmOperationalInternal":{"tmp":"tmp/plugin-agentsmd_1.0.3_1781386425601_0.8075170448911573","host":"s3://npm-registry-packages-npm-production"}},"1.0.4":{"name":"@a16njs/plugin-agentsmd","version":"1.0.4","author":{"name":"Texarkanine"},"license":"AGPL-3.0","_id":"@a16njs/plugin-agentsmd@1.0.4","maintainers":[{"name":"texarkanine","email":"texarkanine@protonmail.com"}],"homepage":"https://texarkanine.github.io/a16n/plugin-agentsmd","bugs":{"url":"https://github.com/Texarkanine/a16n/issues"},"dist":{"shasum":"13bbd2f15256439cebef9a52230d07f7597f77c3","tarball":"https://registry.npmjs.org/@a16njs/plugin-agentsmd/-/plugin-agentsmd-1.0.4.tgz","fileCount":15,"integrity":"sha512-/UhDBxsh7nBXRp5y1nfJ+FX0vDMp+4gi4WB/sz7UQWkNnyDGNtuJoG3parOPIeQ7+RoC7yadtaia6/rRxxSIhw==","signatures":[{"sig":"MEUCIQCJHjW9sPuJ0AZ48nYbOvWyNxKGgaNm/90bnM4h7i8iIgIgDHPTXUxEiJtlsjVf39yZHuDGJsls/7QjWGFSQRYtez4=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"attestations":{"url":"https://registry.npmjs.org/-/npm/v1/attestations/@a16njs%2fplugin-agentsmd@1.0.4","provenance":{"predicateType":"https://slsa.dev/provenance/v1"}},"unpackedSize":63812},"main":"./dist/index.js","type":"module","_from":"file:a16njs-plugin-agentsmd-1.0.4.tgz","types":"./dist/index.d.ts","engines":{"node":">=22.0.0"},"exports":{".":{"types":"./dist/index.d.ts","import":"./dist/index.js"}},"scripts":{"test":"vitest run","build":"tsc","clean":"rimraf dist *.tsbuildinfo","typecheck":"tsc --noEmit","test:watch":"vitest","test:coverage":"vitest run --coverage"},"_npmUser":{"name":"GitHub Actions","email":"npm-oidc-no-reply@github.com","trustedPublisher":{"id":"github","oidcConfigId":"oidc:b84be6a6-537e-4aa1-8ce8-af58a4f49c22"}},"_resolved":"/tmp/df53c61ca15531799706f750e1547171/a16njs-plugin-agentsmd-1.0.4.tgz","_integrity":"sha512-/UhDBxsh7nBXRp5y1nfJ+FX0vDMp+4gi4WB/sz7UQWkNnyDGNtuJoG3parOPIeQ7+RoC7yadtaia6/rRxxSIhw==","repository":{"url":"git+https://github.com/Texarkanine/a16n.git","type":"git","directory":"packages/plugin-agentsmd"},"_npmVersion":"11.5.1","description":"AGENTS.md plugin for a16n","directories":{},"_nodeVersion":"22.22.1","dependencies":{"@a16njs/models":"1.0.0"},"publishConfig":{"access":"public"},"_hasShrinkwrap":false,"devDependencies":{"vitest":"^3.2.6","typescript":"^6.0.3","@types/node":"^25.9.3"},"_npmOperationalInternal":{"tmp":"tmp/plugin-agentsmd_1.0.4_1781392789154_0.18512055751528478","host":"s3://npm-registry-packages-npm-production"}},"1.1.0":{"name":"@a16njs/plugin-agentsmd","version":"1.1.0","description":"AGENTS.md plugin for a16n","license":"AGPL-3.0","author":{"name":"Texarkanine"},"publishConfig":{"access":"public"},"repository":{"type":"git","url":"git+https://github.com/Texarkanine/a16n.git","directory":"packages/plugin-agentsmd"},"homepage":"https://texarkanine.github.io/a16n/plugin-agentsmd","type":"module","main":"./dist/index.js","types":"./dist/index.d.ts","exports":{".":{"types":"./dist/index.d.ts","import":"./dist/index.js"}},"dependencies":{"@a16njs/models":"1.1.0"},"devDependencies":{"@types/node":"^25.9.3","typescript":"^6.0.3","vitest":"^3.2.6"},"engines":{"node":">=22.0.0"},"scripts":{"build":"tsc","clean":"rimraf dist *.tsbuildinfo","typecheck":"tsc --noEmit","test":"vitest run","test:watch":"vitest","test:coverage":"vitest run --coverage"},"_id":"@a16njs/plugin-agentsmd@1.1.0","bugs":{"url":"https://github.com/Texarkanine/a16n/issues"},"_integrity":"sha512-N7xjAqndtAIjt1NrIfYtLvQGzYMk7qJgRKYbdx8weRFaxiXgxB7A6nOW5Aedh7QbkOwPob06m/RhuhSFkS0VQw==","_resolved":"/tmp/15ae67212e4f348bc3373fd2b1bd955d/a16njs-plugin-agentsmd-1.1.0.tgz","_from":"file:a16njs-plugin-agentsmd-1.1.0.tgz","_nodeVersion":"22.22.1","_npmVersion":"11.5.1","dist":{"integrity":"sha512-N7xjAqndtAIjt1NrIfYtLvQGzYMk7qJgRKYbdx8weRFaxiXgxB7A6nOW5Aedh7QbkOwPob06m/RhuhSFkS0VQw==","shasum":"38f5f058111f3b5385a572fb520bed7c08aff03c","tarball":"https://registry.npmjs.org/@a16njs/plugin-agentsmd/-/plugin-agentsmd-1.1.0.tgz","fileCount":15,"unpackedSize":63812,"attestations":{"url":"https://registry.npmjs.org/-/npm/v1/attestations/@a16njs%2fplugin-agentsmd@1.1.0","provenance":{"predicateType":"https://slsa.dev/provenance/v1"}},"signatures":[{"keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U","sig":"MEQCIGiEPWLovDTdPwjsB5GNPJwSSFh6bs+0Kp/dmDJq+3puAiAXbPGjhDvxFNfYo98BQIKSYngyp/oOdIL8sFLVy5n2Xg=="}]},"_npmUser":{"name":"GitHub Actions","email":"npm-oidc-no-reply@github.com","trustedPublisher":{"id":"github","oidcConfigId":"oidc:b84be6a6-537e-4aa1-8ce8-af58a4f49c22"}},"directories":{},"maintainers":[{"name":"texarkanine","email":"texarkanine@protonmail.com"}],"_npmOperationalInternal":{"host":"s3://npm-registry-packages-npm-production","tmp":"tmp/plugin-agentsmd_1.1.0_1785106233041_0.32613260450238535"},"_hasShrinkwrap":false}},"time":{"created":"2026-06-12T21:10:50.601Z","modified":"2026-07-26T22:50:33.468Z","1.0.1":"2026-06-12T21:10:50.908Z","1.0.2":"2026-06-13T20:12:45.840Z","1.0.3":"2026-06-13T21:33:45.748Z","1.0.4":"2026-06-13T23:19:49.286Z","1.1.0":"2026-07-26T22:50:33.185Z"},"bugs":{"url":"https://github.com/Texarkanine/a16n/issues"},"author":{"name":"Texarkanine"},"license":"AGPL-3.0","homepage":"https://texarkanine.github.io/a16n/plugin-agentsmd","repository":{"type":"git","url":"git+https://github.com/Texarkanine/a16n.git","directory":"packages/plugin-agentsmd"},"description":"AGENTS.md plugin for a16n","maintainers":[{"name":"texarkanine","email":"texarkanine@protonmail.com"}],"readme":"# @a16njs/plugin-agentsmd\n\n[![npm version](https://img.shields.io/npm/v/@a16njs/plugin-agentsmd.svg)](https://www.npmjs.com/package/@a16njs/plugin-agentsmd)\n[![codecov](https://codecov.io/gh/Texarkanine/a16n/graph/badge.svg?flag=plugin-agentsmd)](https://codecov.io/gh/Texarkanine/a16n)\n\n[AGENTS.md](https://agents.md/) plugin for a16n. Discovers and emits AGENTS.md files at any directory depth.\n\n## Stability\n\nStable since `1.0.0`: the plugin's `discover`/`emit` behavior follows semantic versioning, and breaking changes to the public API bump the major version.\n\n## Installation\n\nThis plugin is bundled with the `a16n` CLI. For programmatic use:\n\n```bash\nnpm install @a16njs/plugin-agentsmd\n```\n\n## Supported Types\n\n| Type | AGENTS.md Format | Description |\n|------|------------------|-------------|\n| **GlobalPrompt** | root `AGENTS.md` | Always-active instructions |\n| **FileRule** | `<dir>/AGENTS.md` | Directory-scoped instructions (directory-shaped globs only) |\n\nAGENTS.md is plain markdown with no frontmatter, globs, skills, commands, or ignore rules, so **converting into AGENTS.md is lossy** for everything else:\n\n- FileRules whose globs are not directory-shaped (e.g. `*.ts`) are skipped with a warning\n- Skills, manual prompts, and agent-ignore rules are reported as unsupported\n\nConverting *out of* AGENTS.md is lossless.\n\n## Supported Files\n\n### Discovery\n\n- `AGENTS.md` — root instructions (GlobalPrompt)\n- `<dir>/AGENTS.md` — nested instructions at any depth (FileRule with `globs: ['<dir>/**']`)\n\nPer the [AGENTS.md standard](https://agents.md/), a nested AGENTS.md provides instructions scoped to its subtree. a16n encodes that scoping as a directory-shaped glob so it converts into native path-scoped rules:\n\n- Cursor: `.cursor/rules/<dir>/AGENTSMD.mdc` with `globs: <dir>/**`\n- Claude Code: `.claude/rules/<dir>/AGENTSMD.md` with `paths:` frontmatter\n\nDiscovery skips dot-directories and `node_modules`.\n\n### Emission\n\n- **GlobalPrompt** → root `AGENTS.md` (multiple prompts are concatenated, with a `merged` warning)\n- **GlobalPrompt** discovered from a nested `CLAUDE.md` → `<same-dir>/AGENTS.md`\n- **FileRule** with a single directory-shaped glob (`<dir>/**` or `<dir>/**/*`) → `<dir>/AGENTS.md`\n- Everything else → warning or unsupported (see above)\n\nEmission deterministically overwrites target files (output depends only on the converted items, so repeated conversions converge). Replacing a pre-existing `AGENTS.md` whose content differs produces an `overwritten` warning.\n\nWhen converting AGENTS.md into Cursor/Claude rules, a16n emits `AGENTSMD.*` rule filenames. See the plugin docs for rationale and collision behavior details: <https://texarkanine.github.io/a16n/plugin-agentsmd>.\n\n## Usage\n\n```typescript\nimport agentsmdPlugin from '@a16njs/plugin-agentsmd';\nimport { A16nEngine } from '@a16njs/engine';\n\nconst engine = new A16nEngine([agentsmdPlugin]);\n\n// Discover AGENTS.md files\nconst result = await agentsmdPlugin.discover('./my-project');\nconsole.log(`Found ${result.items.length} items`);\n\n// Emit to AGENTS.md format\nawait agentsmdPlugin.emit(result.items, './my-project');\n```\n\n## Documentation\n\nFull documentation available at <https://texarkanine.github.io/a16n/plugin-agentsmd>.\n","readmeFilename":"README.md"}