@guiho/xdocs 0.3.1 → 0.4.2

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.
Files changed (46) hide show
  1. package/CHANGELOG.md +9 -0
  2. package/DOCS.md +60 -27
  3. package/README.md +49 -18
  4. package/docs/2026-07-05-xdocs-document-model.md +77 -0
  5. package/docs/docs.xdocs.md +22 -0
  6. package/jsr.json +1 -1
  7. package/library/agents.d.ts +1 -1
  8. package/library/agents.d.ts.map +1 -1
  9. package/library/agents.js +10 -6
  10. package/library/commands/generate.d.ts.map +1 -1
  11. package/library/commands/generate.js +23 -1
  12. package/library/commands/list.d.ts.map +1 -1
  13. package/library/commands/list.js +14 -4
  14. package/library/commands/merge.d.ts.map +1 -1
  15. package/library/commands/merge.js +12 -1
  16. package/library/commands/scan.d.ts.map +1 -1
  17. package/library/commands/scan.js +13 -2
  18. package/library/config.d.ts.map +1 -1
  19. package/library/config.js +7 -3
  20. package/library/discovery.d.ts +8 -4
  21. package/library/discovery.d.ts.map +1 -1
  22. package/library/discovery.js +107 -17
  23. package/library/flags.d.ts +1 -1
  24. package/library/flags.js +1 -1
  25. package/library/guiho-xdocs.d.ts +2 -2
  26. package/library/guiho-xdocs.d.ts.map +1 -1
  27. package/library/guiho-xdocs.js +1 -1
  28. package/library/help.js +16 -15
  29. package/library/metadata.d.ts +1 -1
  30. package/library/metadata.d.ts.map +1 -1
  31. package/library/metadata.js +23 -3
  32. package/library/tree.d.ts +1 -1
  33. package/library/tree.d.ts.map +1 -1
  34. package/library/tree.js +2 -2
  35. package/library/types.d.ts +14 -2
  36. package/library/types.d.ts.map +1 -1
  37. package/package.json +4 -1
  38. package/prompts/agents.md +9 -2
  39. package/prompts/generate.md +10 -2
  40. package/prompts/prompts.xdocs.md +27 -0
  41. package/prompts/update.md +19 -7
  42. package/prompts/write.md +18 -5
  43. package/scripts/scripts.xdocs.md +5 -0
  44. package/skills/guiho-s-xdocs/SKILL.md +133 -32
  45. package/skills/guiho-s-xdocs/guiho-s-xdocs.xdocs.md +26 -0
  46. package/skills/skills.xdocs.md +9 -4
package/skills/guiho-s-xdocs/guiho-s-xdocs.xdocs.md ADDED
@@ -0,0 +1,26 @@
1
+ ---
2
+ subject: xdocs-guiho-s-xdocs-skill
3
+ description: Packaged guiho-s-xdocs agent skill that teaches AI agents how to maintain xdocs projects.
4
+ parent: xdocs-skills
5
+ children: []
6
+ files: {}
7
+ documents:
8
+ SKILL.md: Versioned xdocs workflow skill installed into .agents/skills or .claude/skills; defines descriptor, companion-document metadata, scan, tree, and maintenance rules.
9
+ tags:
10
+ - skills
11
+ - agents
12
+ - documentation
13
+ keywords:
14
+ - xdocs skill
15
+ - companion metadata
16
+ - agent workflow
17
+ flags: []
18
+ status: stable
19
+ ---
20
+
21
+ The `guiho-s-xdocs/` directory contains the bundled agent skill shipped with the
22
+ package. The installer treats `SKILL.md` as the source of truth and refreshes
23
+ installed copies when the bundled version or content changes.
24
+ The skill also documents the standard frontmatter fields expected on ordinary
25
+ companion Markdown documents: `name`, `purpose`, `description`, `created`,
26
+ `flags`, `tags`, `keywords`, and `owner`.
package/skills/skills.xdocs.md CHANGED
@@ -2,13 +2,18 @@
2
2
  subject: xdocs-skills
3
3
  description: Bundled AI-agent skills shipped with @guiho/xdocs and installed by the xdocs agents commands.
4
4
  parent: xdocs-package
5
- children: []
6
- files:
7
- guiho-s-xdocs/SKILL.md: Versioned xdocs workflow skill installed into .agents/skills or .claude/skills; replaces legacy guiho-as-xdocs installs when refreshed.
5
+ children:
6
+ - xdocs-guiho-s-xdocs-skill
7
+ files: {}
8
+ documents: {}
8
9
  tags:
9
10
  - skills
10
11
  - agents
11
12
  - documentation
13
+ keywords:
14
+ - agent skills
15
+ - bundled skill
16
+ - skill installation
12
17
  flags: []
13
18
  status: stable
14
19
  ---
@@ -16,4 +21,4 @@ status: stable
16
21
  The `skills/` directory contains the bundled `guiho-s-xdocs` agent skill. The
17
22
  installer treats this packaged skill as the current source of truth, removes
18
23
  legacy `guiho-as-xdocs` install directories, and refreshes installed copies when
19
- their frontmatter version or content differs from the bundled file.
24
+ their frontmatter version or content differs from the bundled file.