@huaweidevtools/aishell-dsh-handbook 0.0.15 → 0.0.16

package/README.md

@@ -40,13 +40,16 @@ user's actual question.
 The full text lives in [`src/prompt.ts`](src/prompt.ts); the block above is its
 shape, not its wording.
 
-## Why a list of topics, not an essay
+## Why a list of topics
 
-Each topic is one question a user can ask, answered under its own heading.
-Growing this package means **appending a topic** — never editing an opening
-sentence that counts them. An earlier draft opened with "AI Shell has two
-behaviours worth being able to explain", which made a third behaviour a rewrite
-of the first line. `tests/handbook.spec.ts` fails on that shape coming back.
+Each topic is one question a user can ask, answered under its own heading, and
+nothing in the text counts them. Growing this package is therefore an append: a
+new capability becomes a new heading, and no existing sentence has to be
+rewritten to accommodate it.
+
+A preamble stating how many topics there are would make every addition an edit
+to the line introducing all of them — the one part of the file that has to stay
+true as it grows. `tests/handbook.spec.ts` fails on that shape.
 
 ## Why the UI facts are stated as facts
 

package/lib/index.js

@@ -2,14 +2,14 @@
 /**
 * Position of the handbook in the assembled prompt.
 *
-* A number, not a name, because the framework's placement table is closed:
-* `PromptSectionOrderName` is `keyof` a fixed constant, and there is no slot
-* for product background. `aishell-huaweicloud-docs` documents the same
-* departure at the same kind of position.
+* A number because the framework's placement table is closed:
+* `PromptSectionOrderName` is `keyof` a fixed constant, and no entry names
+* product background. `aishell-huaweicloud-docs` resolves its own position the
+* same way, one step ahead of this one.
 *
-* 110 puts this immediately after that pointer (100), both inside the empty gap
-* the table leaves between the persona prefix (0) and the first policy (500).
-* The two are one band: read where to look things up, then how this product
+* 110 puts this immediately after that pointer (100), both inside the gap the
+* table leaves between the persona prefix (0) and the first policy (500). The
+* two are one band: read where to look things up, then how this product
 * behaves, then what you are asked to reason about.
 */
 const HANDBOOK_ORDER = 110;

package/lib/types/prompt.d.ts

@@ -12,14 +12,14 @@
  * does not exist — or says it does not know, which is worse than the truth for
  * a fact this stable.
  *
- * ## Why the text is a list of topics, not an essay
+ * ## Why the text is a list of topics
  *
  * Each topic is one question a user can ask, answered on its own, under its own
- * heading. Growing this file means appending a topic; it must never mean
- * editing an opening sentence that counts them. An early draft opened with
- * "AI Shell has two behaviours worth being able to explain", which made adding
- * a third behaviour a rewrite of the first line rather than an addition at the
- * end.
+ * heading, and nothing in the text counts them. Growth is therefore an append:
+ * a new capability becomes a new heading, and no existing sentence has to be
+ * rewritten to accommodate it. A preamble that stated how many topics there
+ * are would make every addition an edit to the line introducing all of them,
+ * which is the one part of this file that has to stay true as it grows.
  *
  * ## Why the UI facts are stated as facts
  *
@@ -42,14 +42,14 @@ import type { Context } from '@deepseek-ai/cordis';
 /**
  * Position of the handbook in the assembled prompt.
  *
- * A number, not a name, because the framework's placement table is closed:
- * `PromptSectionOrderName` is `keyof` a fixed constant, and there is no slot
- * for product background. `aishell-huaweicloud-docs` documents the same
- * departure at the same kind of position.
+ * A number because the framework's placement table is closed:
+ * `PromptSectionOrderName` is `keyof` a fixed constant, and no entry names
+ * product background. `aishell-huaweicloud-docs` resolves its own position the
+ * same way, one step ahead of this one.
  *
- * 110 puts this immediately after that pointer (100), both inside the empty gap
- * the table leaves between the persona prefix (0) and the first policy (500).
- * The two are one band: read where to look things up, then how this product
+ * 110 puts this immediately after that pointer (100), both inside the gap the
+ * table leaves between the persona prefix (0) and the first policy (500). The
+ * two are one band: read where to look things up, then how this product
  * behaves, then what you are asked to reason about.
  */
 export declare const HANDBOOK_ORDER = 110;

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@huaweidevtools/aishell-dsh-handbook",
   "description": "Tells LLM how AI Shell works — where feedback goes, what the read-only switch means, how to extend the harness",
-  "version": "0.0.15",
+  "version": "0.0.16",
   "publishConfig": {
     "access": "public"
   },