{"_id":"@amykit/plugin-file-notes","_rev":"4-c1f3e2f97b84aa0eedb0feeb7f5ec00c","name":"@amykit/plugin-file-notes","dist-tags":{"latest":"0.4.0"},"versions":{"0.2.0":{"name":"@amykit/plugin-file-notes","version":"0.2.0","author":{"name":"Nicolas Melo"},"license":"MIT","_id":"@amykit/plugin-file-notes@0.2.0","maintainers":[{"name":"amykit","email":"nicolasmelo12+amykit@gmail.com"}],"homepage":"https://github.com/nicolasmelo1/amy#readme","bugs":{"url":"https://github.com/nicolasmelo1/amy/issues"},"dist":{"shasum":"162afb50d1970164d9f735b5c553c2aede09e9e3","tarball":"https://registry.npmjs.org/@amykit/plugin-file-notes/-/plugin-file-notes-0.2.0.tgz","fileCount":22,"integrity":"sha512-qEXSu5mhqnQU4J6evNA4zI45TUDJETqCHUzL/xo05SPW3IGLoBjv/YB/IVk8xOe3xOS5Wem6MAnRu4B+/dwifQ==","signatures":[{"sig":"MEUCIEsF10k0J8CDXpNobUe9ifpu1TW8hXWYJI5wX0sLTyRfAiEAgAtDpnJBj5aQ/8oo/Sr1YTr1A0ZNazXgMUXOCsz/bNA=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"attestations":{"url":"https://registry.npmjs.org/-/npm/v1/attestations/@amykit%2fplugin-file-notes@0.2.0","provenance":{"predicateType":"https://slsa.dev/provenance/v1"}},"unpackedSize":19999},"main":"./dist/index.js","type":"module","types":"./dist/index.d.ts","exports":{".":{"types":"./dist/index.d.ts","import":"./dist/index.js"}},"gitHead":"b7903f5c95e8154f5db6fd4df6ca2633a628812d","_npmUser":{"name":"amykit","email":"nicolasmelo12+amykit@gmail.com"},"repository":{"url":"git+https://github.com/nicolasmelo1/amy.git","type":"git","directory":"plugins/file-notes"},"_npmVersion":"11.19.0","description":"Friction as a directory of notes: written by hand, by a hook, or by a tick that failed.","directories":{},"_nodeVersion":"24.20.0","dependencies":{"@amykit/core":"^0.2.0","@amykit/plugin-notify-fanout":"^0.2.0"},"publishConfig":{"access":"public","registry":"https://registry.npmjs.org"},"_hasShrinkwrap":false,"devDependencies":{"@amykit/workflow-note-to-plan":"^0.2.0"},"_npmOperationalInternal":{"tmp":"tmp/plugin-file-notes_0.2.0_1788658155007_0.9014571673899443","host":"s3://npm-registry-packages-npm-production"}},"0.3.0":{"name":"@amykit/plugin-file-notes","version":"0.3.0","author":{"name":"Nicolas Melo"},"license":"MIT","_id":"@amykit/plugin-file-notes@0.3.0","maintainers":[{"name":"amykit","email":"nicolasmelo12+amykit@gmail.com"}],"homepage":"https://github.com/nicolasmelo1/amy#readme","bugs":{"url":"https://github.com/nicolasmelo1/amy/issues"},"dist":{"shasum":"2cb03ec1cd5fe0cc69b275a1edbe3b36ed715502","tarball":"https://registry.npmjs.org/@amykit/plugin-file-notes/-/plugin-file-notes-0.3.0.tgz","fileCount":22,"integrity":"sha512-Fhf3c8vtHZC/uSYGIkow6ZLWzj25g+YN/XJtrDe3e5g/ralwtbvhYwAjDHiYFKyEivC4n1N/xWZsOfYxyJbUow==","signatures":[{"sig":"MEQCIDVPiCuOr8XNSiZPFp8T29lq6n8Mz67N/tEIhZjpziuJAiAnKMz3VaNg5JmNV42BMVIq3nQA7nd83ggrJPUaBdtbpg==","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"attestations":{"url":"https://registry.npmjs.org/-/npm/v1/attestations/@amykit%2fplugin-file-notes@0.3.0","provenance":{"predicateType":"https://slsa.dev/provenance/v1"}},"unpackedSize":19999},"main":"./dist/index.js","type":"module","types":"./dist/index.d.ts","exports":{".":{"types":"./dist/index.d.ts","import":"./dist/index.js"}},"gitHead":"a9e241e87a00d8267ad9e992c4ab8fd97bd04480","_npmUser":{"name":"amykit","email":"nicolasmelo12+amykit@gmail.com"},"repository":{"url":"git+https://github.com/nicolasmelo1/amy.git","type":"git","directory":"plugins/file-notes"},"_npmVersion":"11.19.0","description":"Friction as a directory of notes: written by hand, by a hook, or by a tick that failed.","directories":{},"_nodeVersion":"24.20.0","dependencies":{"@amykit/core":"^0.3.0","@amykit/plugin-notify-fanout":"^0.3.0"},"publishConfig":{"access":"public","registry":"https://registry.npmjs.org"},"_hasShrinkwrap":false,"devDependencies":{"@amykit/workflow-note-to-plan":"^0.3.0"},"_npmOperationalInternal":{"tmp":"tmp/plugin-file-notes_0.3.0_1788922135772_0.8352629496235056","host":"s3://npm-registry-packages-npm-production"}},"0.3.1":{"name":"@amykit/plugin-file-notes","version":"0.3.1","author":{"name":"Nicolas Melo"},"license":"MIT","_id":"@amykit/plugin-file-notes@0.3.1","maintainers":[{"name":"amykit","email":"nicolasmelo12+amykit@gmail.com"}],"homepage":"https://github.com/nicolasmelo1/amy#readme","bugs":{"url":"https://github.com/nicolasmelo1/amy/issues"},"dist":{"shasum":"7c0740a04e1ed068997b74c1d54629b56e2eecfd","tarball":"https://registry.npmjs.org/@amykit/plugin-file-notes/-/plugin-file-notes-0.3.1.tgz","fileCount":22,"integrity":"sha512-yF453YcFcyfO/EuaeaMyW3WX8EazarUGr3v4NmzzoL96twXyGvR8g4SJi1GT/rQIRXhm1LXAjzkEoOVJhKZ+XA==","signatures":[{"sig":"MEYCIQD2XAIO/CXjxFbNSzZPOhVWK9th/qS/xDyqh3LGqMX1cgIhAM49lPs/XO+cvrs+zBhICX4wS1yzxYYuj9WazVG1zDfI","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"attestations":{"url":"https://registry.npmjs.org/-/npm/v1/attestations/@amykit%2fplugin-file-notes@0.3.1","provenance":{"predicateType":"https://slsa.dev/provenance/v1"}},"unpackedSize":19999},"main":"./dist/index.js","type":"module","types":"./dist/index.d.ts","exports":{".":{"types":"./dist/index.d.ts","import":"./dist/index.js"}},"gitHead":"6a4c559ad368c51e232a33c4c2221f02709ceb2f","_npmUser":{"name":"amykit","email":"nicolasmelo12+amykit@gmail.com"},"repository":{"url":"git+https://github.com/nicolasmelo1/amy.git","type":"git","directory":"plugins/file-notes"},"_npmVersion":"11.19.0","description":"Friction as a directory of notes: written by hand, by a hook, or by a tick that failed.","directories":{},"_nodeVersion":"24.20.0","dependencies":{"@amykit/core":"^0.3.1","@amykit/plugin-notify-fanout":"^0.3.1"},"publishConfig":{"access":"public","registry":"https://registry.npmjs.org"},"_hasShrinkwrap":false,"devDependencies":{"@amykit/workflow-note-to-plan":"^0.3.1"},"_npmOperationalInternal":{"tmp":"tmp/plugin-file-notes_0.3.1_1788973020435_0.7200781083986143","host":"s3://npm-registry-packages-npm-production"}},"0.4.0":{"_id":"@amykit/plugin-file-notes@0.4.0","bugs":{"url":"https://github.com/nicolasmelo1/amy/issues"},"dist":{"shasum":"af8420d75384743be0ac1f009cebc10b80e148d0","tarball":"https://registry.npmjs.org/@amykit/plugin-file-notes/-/plugin-file-notes-0.4.0.tgz","fileCount":22,"integrity":"sha512-22hh4VsK2AtnsMp14zbtJZZE9zRPhuLN97UGYJQ/diRTVDQgLgsUkL6vq8mkwmYigxnjBUnEv1Nk2hqTTDW3Gw==","signatures":[{"sig":"MEUCIQCed0/iQX53onVrsNq918HC/yQBy8Sud3lG7NnGLW1pRQIgW6+oKIfuKJRJQCFcRhW+Y7ilM6Cs1tZBZ9PrENsHJQU=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"},{"keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U","sig":"MEQCIAMllLj4gJ9kT/a73vhDiN41yhXY+fufBGD+6YfzgNfbAiASRbi2TRrUuHZkk9rpu37guG0WzCWWsEI0cHcuhdI3RA=="}],"attestations":{"url":"https://registry.npmjs.org/-/npm/v1/attestations/@amykit%2fplugin-file-notes@0.4.0","provenance":{"predicateType":"https://slsa.dev/provenance/v1"}},"unpackedSize":19999},"main":"./dist/index.js","name":"@amykit/plugin-file-notes","type":"module","types":"./dist/index.d.ts","author":{"name":"Nicolas Melo"},"exports":{".":{"types":"./dist/index.d.ts","import":"./dist/index.js"}},"gitHead":"ac437aba051bd8e109e1eb8b3c32b0365c6b4e2e","license":"MIT","version":"0.4.0","_npmUser":{"name":"amykit","email":"nicolasmelo12+amykit@gmail.com"},"homepage":"https://github.com/nicolasmelo1/amy#readme","repository":{"url":"git+https://github.com/nicolasmelo1/amy.git","type":"git","directory":"plugins/file-notes"},"_npmVersion":"11.19.0","description":"Friction as a directory of notes: written by hand, by a hook, or by a tick that failed.","directories":{},"maintainers":[{"name":"amykit","email":"nicolasmelo12+amykit@gmail.com"}],"_nodeVersion":"24.20.0","dependencies":{"@amykit/core":"^0.4.0","@amykit/plugin-notify-fanout":"^0.4.0"},"publishConfig":{"access":"public","registry":"https://registry.npmjs.org"},"_hasShrinkwrap":false,"devDependencies":{"@amykit/workflow-note-to-plan":"^0.4.0"},"_npmOperationalInternal":{"host":"s3://npm-registry-packages-npm-production","tmp":"tmp/plugin-file-notes_0.4.0_1789739897411_0.7972868374746813"}}},"time":{"created":"2026-09-06T01:29:14.856Z","modified":"2026-09-18T13:58:17.796Z","0.2.0":"2026-09-06T01:29:15.143Z","0.3.0":"2026-09-09T02:48:55.915Z","0.3.1":"2026-09-09T16:57:00.568Z","0.4.0":"2026-09-18T13:58:17.506Z"},"bugs":{"url":"https://github.com/nicolasmelo1/amy/issues"},"author":{"name":"Nicolas Melo"},"license":"MIT","homepage":"https://github.com/nicolasmelo1/amy#readme","repository":{"url":"git+https://github.com/nicolasmelo1/amy.git","type":"git","directory":"plugins/file-notes"},"description":"Friction as a directory of notes: written by hand, by a hook, or by a tick that failed.","maintainers":[{"name":"amykit","email":"nicolasmelo12+amykit@gmail.com"}],"readme":"<!-- Generated by `npm run docs:generate` from the package itself. Do not edit by hand. -->\n\n# @amykit/plugin-file-notes\n\nFriction as a directory of notes: written by hand, by a hook, or by a tick that failed.\n\nA plugin for [amy](https://github.com/nicolasmelo1/amy). It provides the `notes` port.\n\n## Install\n\n```sh\nnpm install -g @amykit/plugin-file-notes\n```\n\nThen name it in `~/.amy/config.yaml`:\n\n```yaml\nworkflows:\n  your-profile:\n    plugins:\n      - \"@amykit/plugin-file-notes\"\n```\n\n## Configuration\n\n```yaml\nplugins:\n  \"@amykit/plugin-file-notes\":\n    directory: \"notes\"\n    repo: \"\"\n    writeFailureNotes: true\n```\n\n| Setting | Type | Required | Default | What it is |\n| :-- | :-- | :-- | :-- | :-- |\n| `directory` | `string` | no | `notes` | where the notes are watched for, relative to the state directory |\n| `repo` | `string` | no | `\"\"` | the repository a note is about when it does not say, which is also the one this machine's own failures are filed against |\n| `writeFailureNotes` | `boolean` | no | `true` | whether a tick this machine gave up on leaves a note behind, so the thing that broke becomes the thing that gets fixed |\n\nEvery field is checked at boot against the schema this package declares. A key that is\nnot one of the above is a refusal naming the plugin and the key, not a setting that\nsilently never applied.\n\n## Where the reasoning is\n\n- [Writing a plugin](https://github.com/nicolasmelo1/amy/tree/main/docs/build/write-a-plugin.md)\n- [Reference: plugins](https://github.com/nicolasmelo1/amy/tree/main/docs/reference/plugins.md)\n- [Ports and the registry](https://github.com/nicolasmelo1/amy/tree/main/docs/concepts/ports.md)\n\n## Licence\n\nMIT\n","readmeFilename":"README.md"}