Commit c243eed
authored
feat(framework+cli): fw-4.15.0 / cli-3.13.2 — inject AGENTS.md universal standard (#155)
* feat(framework): fw-4.15.0 — inject AGENTS.md universal standard
Adds AGENTS.md as a first-class injection target. AGENTS.md is the
open standard for AI coding agents donated to the Agentic AI
Foundation (Linux Foundation, 2025) and read by Claude Code,
OpenAI Codex CLI, Cursor, Aider, Devin, Sourcegraph Amp, Google
Jules, Zed AI, Continue, Roo Code, Factory Droids, GitHub Copilot,
Gemini CLI, Windsurf, Amazon Q and others.
Before fw-4.15.0, StrayMark injected directives only into
platform-specific files (CLAUDE.md, GEMINI.md, copilot-instructions,
.cursorrules, cursor/rules/straymark.md); adopters using any of the
other 15+ CLIs had to copy directives by hand. From this release,
straymark init and update-framework keep AGENTS.md in sync with
STRAYMARK.md automatically.
- New template dist/dist-templates/directives/AGENTS.md (reference
shape; pointer to STRAYMARK.md plus minimum-viable body for
agents that cannot follow relative links)
- New injection entry in dist/dist-manifest.yml, placed first as
the universal entry point
- STRAYMARK.md documents AGENTS.md coexistence with CLI-specific
files (different identity strings, same source of truth)
- remove.rs legacy fallback updated to clean AGENTS.md for
installations that lose .straymark/dist-manifest.yml
- Three new integration tests in cli/tests/inject_test.rs:
template-has-markers, manifest-declares-injection,
coexists-with-preexisting-file
- Governance footers and version tables bumped to v4.15.0 across
EN + i18n/es + i18n/zh-CN
- README and ADOPTION-GUIDE list AGENTS.md as the universal entry
point with the full reader-CLI inventory
CLI version unchanged (cli-3.13.1 remains the matching version).
No behavior change for adopters that already maintain AGENTS.md
manually: the injection appends a marker block, preserves
existing custom content, and is idempotent.
* chore: bump CLI to 3.13.2 for AGENTS.md in remove fallback
The data-driven cleanup path in remove.rs already handles AGENTS.md
correctly via the manifest read; the previous commit also extended
the LEGACY_DIRECTIVE_TARGETS fallback so `straymark remove` cleans
AGENTS.md even when the local manifest is missing or fails to parse.
That is a behavioral change in the released binary and warrants a
matching CLI bump per project versioning policy.
- cli/Cargo.toml + Cargo.lock: 3.13.1 → 3.13.2
- CHANGELOG: section header retitled `Framework 4.15.0 / CLI 3.13.2`
with a new `### Added (CLI)` subsection documenting the rationale
- Version tables and example outputs in README + CLI-REFERENCE
(EN + ES + zh-CN) updated to cli-3.13.2
- Adopter guidance reworked to mention update-cli alongside
update-framework
No behavior change beyond the LEGACY_DIRECTIVE_TARGETS extension
already shipped in the previous commit.
* docs(cli): add crate-focused README for crates.io listing
Crates.io was previously showing a runtime copy of the root README
(approximately 650 lines, badges-heavy, navigation-heavy) made by
release-cli.yml at publish time. That format is tuned for GitHub
visitors landing on the project, not for Rust devs evaluating the
crate from a crates.io search.
This commit ships a dedicated cli/README.md tailored to the
crates.io audience: tagline, what-it-is paragraph, install (cargo
install + prebuilt binaries for 4 platforms), 5-line quickstart,
six bullets of core capabilities, multi-CLI agent support note
with the AGENTS.md context, features table, and links back to the
full docs on GitHub. Length: ~110 lines.
Workflow change: removes the `cp README.md cli/README.md` step
from release-cli.yml so cargo publish uses the file shipped in
the repo instead of overwriting it with the root README at CI
time. cargo package --list confirms the new README is included
in the .crate artifact.
No behavior change to the CLI binary; this affects only what
crates.io renders on the package page for cli-3.13.2 and later.1 parent d05cdd8 commit c243eed
35 files changed
Lines changed: 358 additions & 83 deletions
File tree
- .github/workflows
- cli
- src/commands
- tests
- dist
- .straymark
- 00-governance
- i18n
- es
- zh-CN
- dist-templates/directives
- docs
- adopters
- i18n
- es
- adopters
- zh-CN
- adopters
| Original file line number | Diff line number | Diff line change | |
|---|---|---|---|
| |||
181 | 181 | | |
182 | 182 | | |
183 | 183 | | |
184 | | - | |
185 | | - | |
186 | | - | |
187 | 184 | | |
188 | 185 | | |
189 | 186 | | |
| |||
| Original file line number | Diff line number | Diff line change | |
|---|---|---|---|
| |||
7 | 7 | | |
8 | 8 | | |
9 | 9 | | |
| 10 | + | |
| 11 | + | |
| 12 | + | |
| 13 | + | |
| 14 | + | |
| 15 | + | |
| 16 | + | |
| 17 | + | |
| 18 | + | |
| 19 | + | |
| 20 | + | |
| 21 | + | |
| 22 | + | |
| 23 | + | |
| 24 | + | |
| 25 | + | |
| 26 | + | |
| 27 | + | |
| 28 | + | |
| 29 | + | |
| 30 | + | |
| 31 | + | |
| 32 | + | |
| 33 | + | |
| 34 | + | |
| 35 | + | |
| 36 | + | |
| 37 | + | |
| 38 | + | |
| 39 | + | |
| 40 | + | |
| 41 | + | |
| 42 | + | |
10 | 43 | | |
11 | 44 | | |
12 | 45 | | |
| |||
| Original file line number | Diff line number | Diff line change | |
|---|---|---|---|
| |||
99 | 99 | | |
100 | 100 | | |
101 | 101 | | |
102 | | - | |
| 102 | + | |
103 | 103 | | |
104 | 104 | | |
105 | 105 | | |
| |||
123 | 123 | | |
124 | 124 | | |
125 | 125 | | |
| 126 | + | |
126 | 127 | | |
127 | 128 | | |
128 | 129 | | |
| |||
180 | 181 | | |
181 | 182 | | |
182 | 183 | | |
183 | | - | |
| 184 | + | |
184 | 185 | | |
185 | 186 | | |
186 | 187 | | |
| |||
193 | 194 | | |
194 | 195 | | |
195 | 196 | | |
196 | | - | |
| 197 | + | |
197 | 198 | | |
198 | 199 | | |
199 | 200 | | |
| |||
274 | 275 | | |
275 | 276 | | |
276 | 277 | | |
277 | | - | |
278 | | - | |
279 | | - | |
| 278 | + | |
| 279 | + | |
| 280 | + | |
280 | 281 | | |
281 | 282 | | |
282 | 283 | | |
283 | 284 | | |
284 | 285 | | |
285 | 286 | | |
286 | | - | |
| 287 | + | |
287 | 288 | | |
288 | 289 | | |
289 | 290 | | |
| |||
308 | 309 | | |
309 | 310 | | |
310 | 311 | | |
311 | | - | |
| 312 | + | |
312 | 313 | | |
313 | 314 | | |
314 | 315 | | |
| |||
328 | 329 | | |
329 | 330 | | |
330 | 331 | | |
331 | | - | |
| 332 | + | |
332 | 333 | | |
333 | 334 | | |
334 | 335 | | |
| |||
339 | 340 | | |
340 | 341 | | |
341 | 342 | | |
342 | | - | |
| 343 | + | |
343 | 344 | | |
344 | 345 | | |
345 | 346 | | |
| |||
486 | 487 | | |
487 | 488 | | |
488 | 489 | | |
489 | | - | |
| 490 | + | |
490 | 491 | | |
491 | 492 | | |
492 | 493 | | |
| |||
533 | 534 | | |
534 | 535 | | |
535 | 536 | | |
536 | | - | |
| 537 | + | |
537 | 538 | | |
538 | 539 | | |
539 | 540 | | |
| |||
557 | 558 | | |
558 | 559 | | |
559 | 560 | | |
560 | | - | |
| 561 | + | |
561 | 562 | | |
562 | 563 | | |
563 | 564 | | |
| |||
573 | 574 | | |
574 | 575 | | |
575 | 576 | | |
576 | | - | |
| 577 | + | |
| 578 | + | |
577 | 579 | | |
578 | 580 | | |
579 | 581 | | |
| |||
582 | 584 | | |
583 | 585 | | |
584 | 586 | | |
585 | | - | |
| 587 | + | |
586 | 588 | | |
587 | 589 | | |
588 | 590 | | |
589 | 591 | | |
590 | 592 | | |
591 | 593 | | |
592 | 594 | | |
593 | | - | |
| 595 | + | |
594 | 596 | | |
595 | 597 | | |
596 | 598 | | |
| |||
623 | 625 | | |
624 | 626 | | |
625 | 627 | | |
626 | | - | |
| 628 | + | |
627 | 629 | | |
628 | 630 | | |
629 | 631 | | |
630 | 632 | | |
631 | | - | |
632 | | - | |
633 | | - | |
| 633 | + | |
| 634 | + | |
| 635 | + | |
634 | 636 | | |
635 | 637 | | |
636 | 638 | | |
| |||
Some generated files are not rendered by default. Learn more about customizing how changed files appear on GitHub.
| Original file line number | Diff line number | Diff line change | |
|---|---|---|---|
| |||
1 | 1 | | |
2 | 2 | | |
3 | | - | |
| 3 | + | |
4 | 4 | | |
5 | 5 | | |
6 | 6 | | |
| |||
| Original file line number | Diff line number | Diff line change | |
|---|---|---|---|
| |||
| 1 | + | |
| 2 | + | |
| 3 | + | |
| 4 | + | |
| 5 | + | |
| 6 | + | |
| 7 | + | |
| 8 | + | |
| 9 | + | |
| 10 | + | |
| 11 | + | |
| 12 | + | |
| 13 | + | |
| 14 | + | |
| 15 | + | |
| 16 | + | |
| 17 | + | |
| 18 | + | |
| 19 | + | |
| 20 | + | |
| 21 | + | |
| 22 | + | |
| 23 | + | |
| 24 | + | |
| 25 | + | |
| 26 | + | |
| 27 | + | |
| 28 | + | |
| 29 | + | |
| 30 | + | |
| 31 | + | |
| 32 | + | |
| 33 | + | |
| 34 | + | |
| 35 | + | |
| 36 | + | |
| 37 | + | |
| 38 | + | |
| 39 | + | |
| 40 | + | |
| 41 | + | |
| 42 | + | |
| 43 | + | |
| 44 | + | |
| 45 | + | |
| 46 | + | |
| 47 | + | |
| 48 | + | |
| 49 | + | |
| 50 | + | |
| 51 | + | |
| 52 | + | |
| 53 | + | |
| 54 | + | |
| 55 | + | |
| 56 | + | |
| 57 | + | |
| 58 | + | |
| 59 | + | |
| 60 | + | |
| 61 | + | |
| 62 | + | |
| 63 | + | |
| 64 | + | |
| 65 | + | |
| 66 | + | |
| 67 | + | |
| 68 | + | |
| 69 | + | |
| 70 | + | |
| 71 | + | |
| 72 | + | |
| 73 | + | |
| 74 | + | |
| 75 | + | |
| 76 | + | |
| 77 | + | |
| 78 | + | |
| 79 | + | |
| 80 | + | |
| 81 | + | |
| 82 | + | |
| 83 | + | |
| 84 | + | |
| 85 | + | |
| 86 | + | |
| 87 | + | |
| 88 | + | |
| 89 | + | |
| 90 | + | |
| 91 | + | |
| 92 | + | |
| 93 | + | |
| 94 | + | |
| 95 | + | |
| 96 | + | |
| 97 | + | |
| 98 | + | |
| 99 | + | |
| 100 | + | |
| 101 | + | |
| 102 | + | |
| 103 | + | |
| 104 | + | |
| 105 | + | |
| 106 | + | |
| 107 | + | |
0 commit comments