octwin-cli 0.9.1 → 0.9.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.
package/CHANGELOG.md CHANGED
@@ -7,6 +7,14 @@ repo root [`CHANGELOG.md`](../../CHANGELOG.md); this file is the CLI-only cut th
7
7
 
8
8
  ## [Unreleased]
9
9
 
10
+ ## [0.9.2] - 2026-10-22
11
+
12
+ ### Changed
13
+ - **`SYMBOLS.md` says what each builtin does, beside its signature.** A builtin's row showed only
14
+ `(str: unknown, n: unknown, ellipsis?: unknown): string`, so `$first_n` read as "the first N items" and an
15
+ author fed it to a list (aani-dani, 2026-10-20) — it is the first N WORDS. The row is now the signature,
16
+ then the catalog's one-sentence summary. (`src/lib/kb-symbols.ts`)
17
+
10
18
  ## [0.9.1] - 2026-10-22
11
19
 
12
20
  ### Fixed
@@ -78,10 +78,15 @@ const EXTRACTORS = {
78
78
  },
79
79
  builtins(entry, file) {
80
80
  const v = obj(entry.value);
81
- // `$` is how an author writes it, and how they will grep for it.
81
+ // `$` is how an author writes it, and how they will grep for it. The line carries the
82
+ // signature AND what it does: `(str, n): string` alone let an author take `$first_n` for
83
+ // "the first N items" — it is the first N WORDS (aani-dani, 2026-10-20). Longer clamp than
84
+ // the other rows, so the sentence survives beside the signature.
85
+ const sig = str(v?.signature);
86
+ const what = str(v?.summary) ?? str(entry.summary);
82
87
  return [{
83
88
  symbol: `$${entry.name}`, kind: 'builtin', file,
84
- summary: line(str(v?.signature) ?? entry.summary),
89
+ summary: line(sig && what ? `${sig} — ${what}` : sig ?? what, 180),
85
90
  }];
86
91
  },
87
92
  templates(entry, file) {
package/package.json CHANGED
@@ -1,46 +1,46 @@
1
- {
2
- "name": "octwin-cli",
3
- "version": "0.9.1",
4
- "description": "Octwin external-pack developer CLI (by CEQUENS) — scaffold, validate, deploy, and check pure-YAML packs on your tenant.",
5
- "type": "module",
6
- "bin": {
7
- "octwin": "dist/index.js"
8
- },
9
- "files": [
10
- "dist",
11
- "templates",
12
- "README.md",
13
- "CHANGELOG.md",
14
- "LICENSE"
15
- ],
16
- "engines": {
17
- "node": ">=22"
18
- },
19
- "scripts": {
20
- "build": "tsc -p tsconfig.json",
21
- "prepublishOnly": "npm run build"
22
- },
23
- "dependencies": {
24
- "yaml": "^2.6.0"
25
- },
26
- "devDependencies": {
27
- "@types/node": "^22.0.0",
28
- "typescript": "^5.7.0"
29
- },
30
- "publishConfig": {
31
- "access": "public"
32
- },
33
- "keywords": [
34
- "octwin",
35
- "cequens",
36
- "cli",
37
- "whatsapp",
38
- "chatbot",
39
- "pack",
40
- "conversational-ai",
41
- "yaml"
42
- ],
43
- "author": "CEQUENS",
44
- "homepage": "https://octwin.ai",
45
- "license": "MIT"
46
- }
1
+ {
2
+ "name": "octwin-cli",
3
+ "version": "0.9.2",
4
+ "description": "Octwin external-pack developer CLI (by CEQUENS) — scaffold, validate, deploy, and check pure-YAML packs on your tenant.",
5
+ "type": "module",
6
+ "bin": {
7
+ "octwin": "dist/index.js"
8
+ },
9
+ "files": [
10
+ "dist",
11
+ "templates",
12
+ "README.md",
13
+ "CHANGELOG.md",
14
+ "LICENSE"
15
+ ],
16
+ "engines": {
17
+ "node": ">=22"
18
+ },
19
+ "scripts": {
20
+ "build": "tsc -p tsconfig.json",
21
+ "prepublishOnly": "npm run build"
22
+ },
23
+ "dependencies": {
24
+ "yaml": "^2.6.0"
25
+ },
26
+ "devDependencies": {
27
+ "@types/node": "^22.0.0",
28
+ "typescript": "^5.7.0"
29
+ },
30
+ "publishConfig": {
31
+ "access": "public"
32
+ },
33
+ "keywords": [
34
+ "octwin",
35
+ "cequens",
36
+ "cli",
37
+ "whatsapp",
38
+ "chatbot",
39
+ "pack",
40
+ "conversational-ai",
41
+ "yaml"
42
+ ],
43
+ "author": "CEQUENS",
44
+ "homepage": "https://octwin.ai",
45
+ "license": "MIT"
46
+ }