@ascribed/cli 0.4.3 → 0.4.4-next.32
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/package.json +6 -5
- package/skills/ascribe/SKILL.md +3 -1
package/package.json
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "@ascribed/cli",
|
|
3
|
-
"version": "0.4.
|
|
3
|
+
"version": "0.4.4-next.32",
|
|
4
4
|
"description": "A toolchain for documentation written as code. This package installs its command, ascribe.",
|
|
5
5
|
"type": "module",
|
|
6
6
|
"license": "MPL-2.0",
|
|
@@ -40,10 +40,10 @@
|
|
|
40
40
|
"node": ">=24"
|
|
41
41
|
},
|
|
42
42
|
"optionalDependencies": {
|
|
43
|
-
"@ascribed/cli-darwin-arm64": "0.4.
|
|
44
|
-
"@ascribed/cli-linux-arm64": "0.4.
|
|
45
|
-
"@ascribed/cli-linux-x64": "0.4.
|
|
46
|
-
"@ascribed/cli-win32-x64": "0.4.
|
|
43
|
+
"@ascribed/cli-darwin-arm64": "0.4.4-next.32",
|
|
44
|
+
"@ascribed/cli-linux-arm64": "0.4.4-next.32",
|
|
45
|
+
"@ascribed/cli-linux-x64": "0.4.4-next.32",
|
|
46
|
+
"@ascribed/cli-win32-x64": "0.4.4-next.32"
|
|
47
47
|
},
|
|
48
48
|
"devDependencies": {
|
|
49
49
|
"@types/node": "^24.19.2"
|
|
@@ -51,6 +51,7 @@
|
|
|
51
51
|
"publishConfig": {
|
|
52
52
|
"access": "public"
|
|
53
53
|
},
|
|
54
|
+
"gitHead": "0c61ee6284117bcbac4e40c7feca78d9a92e177e",
|
|
54
55
|
"scripts": {
|
|
55
56
|
"build": "tsc -p tsconfig.json",
|
|
56
57
|
"typecheck": "tsc --noEmit",
|
package/skills/ascribe/SKILL.md
CHANGED
|
@@ -3,7 +3,7 @@ name: ascribe
|
|
|
3
3
|
description: "Write and fix Markdown docs in an Ascribe project: pages with YAML frontmatter, `@` directives, and `{phrase}` keys, checked against the content model in `ascribe.toml`. Use when adding or editing pages in a folder with an `ascribe.toml`, fixing what `ascribe check` reports, or finding which frontmatter, directives, and phrases the project allows."
|
|
4
4
|
license: MPL-2.0
|
|
5
5
|
metadata:
|
|
6
|
-
ascribe-version: "0.4.
|
|
6
|
+
ascribe-version: "0.4.4-next.32"
|
|
7
7
|
---
|
|
8
8
|
|
|
9
9
|
# Ascribe
|
|
@@ -46,6 +46,8 @@ Use the commands when you have a shell. Without one, use the `ascribe_*` tools o
|
|
|
46
46
|
|
|
47
47
|
`ascribe rename <target> <new>` renames a phrase (`phrase:product`), a dimension's value (`value:cloud`), a heading's id (`guides/install.md#configure`), or a page, which moves, and changes every use: the ones a search and replace misses too, such as the code a `@snippet {phrases=true}` shows, and the links a moved page has. Use it instead of editing each use.
|
|
48
48
|
|
|
49
|
+
In a project with an `ascribe.addresses`, which keeps the addresses the docs have published, a page's old address must still lead somewhere. `ascribe rename` records a page's move there. After moving pages with `git mv`, run `ascribe addresses move --from-git` to record the moves git sees. For a page deleted on purpose, forward its address to the page that covers it now, with `ascribe addresses move <old> <page>`, or retire it, with `ascribe addresses retire <old> --reason "<why>"`. `ascribe check` reports `address-lost` for a page that's gone without either, with these as its fixes. Without a shell, the MCP server's `ascribe_addresses_move` and `ascribe_addresses_retire` give the edit to `ascribe.addresses` to apply.
|
|
50
|
+
|
|
49
51
|
## Checking in CI
|
|
50
52
|
|
|
51
53
|
A CI job runs two commands: `ascribe check --deny-warnings`, which fails on an error or a warning in any build, and `ascribe fmt --check`, which fails on a page `ascribe fmt` would change. Run them where `ascribe.toml` is, or give each `--config <folder>`.
|