@agentmarkup/astro 0.3.2 → 0.3.4
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/LICENSE +1 -1
- package/README.md +11 -3
- package/package.json +4 -3
package/LICENSE
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
MIT License
|
|
2
2
|
|
|
3
|
-
Copyright (c)
|
|
3
|
+
Copyright (c) 2026 Sebastian Cochinescu and Anima Felix
|
|
4
4
|
|
|
5
5
|
Permission is hereby granted, free of charge, to any person obtaining a copy
|
|
6
6
|
of this software and associated documentation files (the "Software"), to deal
|
package/README.md
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
# @agentmarkup/astro
|
|
2
2
|
|
|
3
|
-
Build-time `llms.txt`, JSON-LD, markdown mirrors, AI crawler `robots.txt`, headers, and validation for Astro websites.
|
|
3
|
+
Build-time `llms.txt`, optional `llms-full.txt`, JSON-LD, markdown mirrors, AI crawler `robots.txt`, headers, and validation for Astro websites.
|
|
4
4
|
|
|
5
5
|
## Install
|
|
6
6
|
|
|
@@ -34,6 +34,9 @@ export default defineConfig({
|
|
|
34
34
|
},
|
|
35
35
|
],
|
|
36
36
|
},
|
|
37
|
+
llmsFullTxt: {
|
|
38
|
+
enabled: true,
|
|
39
|
+
},
|
|
37
40
|
markdownPages: {
|
|
38
41
|
enabled: true,
|
|
39
42
|
},
|
|
@@ -88,22 +91,27 @@ export default defineConfig({
|
|
|
88
91
|
|
|
89
92
|
- Injects JSON-LD into built HTML pages during the Astro build
|
|
90
93
|
- Generates `/llms.txt` from config
|
|
94
|
+
- Generates optional `/llms-full.txt` with inlined same-site markdown content
|
|
95
|
+
- Injects the homepage `llms.txt` discovery link automatically
|
|
91
96
|
- Validates JSON-LD already present in page HTML
|
|
92
|
-
- Generates `.md` mirrors from the final HTML output
|
|
97
|
+
- Generates `.md` mirrors from the final HTML output when a cleaner agent-facing fetch path is useful
|
|
93
98
|
- Patches or creates `robots.txt` with AI crawler directives
|
|
94
99
|
- Patches or creates `_headers` with `Content-Signal` and canonical `Link` headers for markdown mirrors
|
|
95
100
|
- Validates common schema and crawler mistakes at build time
|
|
96
101
|
- Warns when a page looks like a thin client-rendered HTML shell
|
|
102
|
+
- Warns when markdown alternate links or `llms.txt` mirror coverage drift out of sync
|
|
97
103
|
- Re-exports `@agentmarkup/core` helpers for custom pipelines
|
|
98
104
|
|
|
99
105
|
By default, the Astro adapter coexists with existing machine-readable assets. If a page already contains JSON-LD for a schema type, or the site already ships a curated `llms.txt` or matching crawler rules, those are preserved unless you opt into replacement.
|
|
100
106
|
|
|
101
|
-
Markdown mirrors stay directly fetchable for agents, while their `_headers` entries point search engines back at the HTML page as canonical. Existing files are still preserved unless you opt into replacement with `markdownPages.replaceExisting` or `contentSignalHeaders.replaceExisting`.
|
|
107
|
+
Markdown mirrors are optional. They are usually most useful for thin, noisy, or client-rendered HTML where the raw page is a weak fetch target for agents. The generated `.md` files stay directly fetchable for agents, while their `_headers` entries point search engines back at the HTML page as canonical. Existing files are still preserved unless you opt into replacement with `markdownPages.replaceExisting` or `contentSignalHeaders.replaceExisting`.
|
|
102
108
|
|
|
103
109
|
When markdown mirrors are enabled, the adapter also writes canonical `Link` headers for those `.md` files so search engines can keep the HTML route as the preferred indexed URL without making the markdown mirror unavailable to direct fetchers.
|
|
104
110
|
|
|
105
111
|
When markdown mirrors are enabled, same-site page entries in `llms.txt` automatically point at the generated `.md` mirrors by default. Set `llmsTxt.preferMarkdownMirrors: false` if you want `llms.txt` to keep linking to HTML routes instead.
|
|
106
112
|
|
|
113
|
+
Enable `llmsFullTxt` when you want a richer companion file for agents that can consume more than the compact `llms.txt` manifest. The generated `llms-full.txt` keeps the same section structure but inlines same-site markdown mirror content when those mirrors exist.
|
|
114
|
+
|
|
107
115
|
## Maintainer
|
|
108
116
|
|
|
109
117
|
Copyright (c) 2026 [Sebastian Cochinescu](https://www.cochinescu.com). MIT License.
|
package/package.json
CHANGED
|
@@ -1,7 +1,7 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "@agentmarkup/astro",
|
|
3
|
-
"version": "0.3.
|
|
4
|
-
"description": "Build-time llms.txt, JSON-LD, markdown mirrors, headers, AI crawler controls, and validation for Astro",
|
|
3
|
+
"version": "0.3.4",
|
|
4
|
+
"description": "Build-time llms.txt, llms-full.txt, JSON-LD, markdown mirrors, headers, AI crawler controls, and validation for Astro",
|
|
5
5
|
"type": "module",
|
|
6
6
|
"license": "MIT",
|
|
7
7
|
"author": "Sebastian Cochinescu <hello@animafelix.com> (https://animafelix.com)",
|
|
@@ -17,6 +17,7 @@
|
|
|
17
17
|
"keywords": [
|
|
18
18
|
"astro",
|
|
19
19
|
"llms-txt",
|
|
20
|
+
"llms-full",
|
|
20
21
|
"json-ld",
|
|
21
22
|
"markdown",
|
|
22
23
|
"schema-org",
|
|
@@ -41,7 +42,7 @@
|
|
|
41
42
|
"dist"
|
|
42
43
|
],
|
|
43
44
|
"dependencies": {
|
|
44
|
-
"@agentmarkup/core": "0.3.
|
|
45
|
+
"@agentmarkup/core": "0.3.4"
|
|
45
46
|
},
|
|
46
47
|
"peerDependencies": {
|
|
47
48
|
"astro": ">=4.0.0"
|