@staff0rd/assist 0.659.1 → 0.660.0

package/dist/index.js

@@ -6,7 +6,7 @@ import { Command } from "commander";
 // package.json
 var package_default = {
   name: "@staff0rd/assist",
-  version: "0.659.1",
+  version: "0.660.0",
   type: "module",
   main: "dist/index.js",
   bin: {
@@ -562,6 +562,21 @@ function stripLegacyConfigKeys(config) {
 import { z as z3 } from "zod";
 
 // src/shared/adviceFragmentNames.ts
+var adviceFragmentTitles = {
+  "assist-global": "Using assist",
+  "backlog-ids": "Backlog item IDs",
+  "backlog-prs": "Backlog items, PRs, and commits",
+  "code-comments": "Commenting code",
+  "drafting-messages": "Drafting messages to send on the user's behalf",
+  "editing-files": "Editing files",
+  "filename-convention": "Naming files after their export",
+  "jira-context": "Fetching Jira context",
+  "jira-smart-links": "Editing Jira issues with Smart Links",
+  markdown: "Writing markdown",
+  refactor: "Renaming and extracting TypeScript",
+  "settings-json": "Editing claude/settings.json",
+  verify: "Verifying a change"
+};
 var adviceFragmentNames = [
   "assist-global",
   "backlog-ids",
@@ -2101,10 +2116,10 @@ function reportVerifyProblems(problems, success) {
 }
 
 // src/commands/verify/adviceFragments.ts
+var titles = adviceFragmentTitles;
 function adviceFragments() {
-  const shipped = new Set(
-    loadAdviceFragments().map((fragment) => fragment.name)
-  );
+  const fragments = loadAdviceFragments();
+  const shipped = new Set(fragments.map((fragment) => fragment.name));
   const declared = new Set(adviceFragmentNames);
   reportVerifyProblems(
     [
@@ -2115,9 +2130,15 @@ function adviceFragments() {
       verifySection(
         "Listed in adviceFragmentNames but no longer shipped in claude/advice (remove them)",
         [...declared].filter((name) => !shipped.has(name))
+      ),
+      verifySection(
+        "adviceFragmentTitles disagrees with the fragment's own title (the config picker shows these, so they must match)",
+        fragments.filter((fragment) => titles[fragment.name] !== fragment.title).map(
+          (fragment) => `${fragment.name}: "${titles[fragment.name] ?? ""}" should be "${fragment.title}"`
+        )
       )
     ],
-    `All ${shipped.size} advice fragments are named in adviceFragmentNames.`
+    `All ${shipped.size} advice fragments are named and titled in adviceFragmentNames.`
   );
 }
 
@@ -2842,6 +2863,33 @@ function configHelp(command, entries, preamble) {
   );
 }
 
+// src/shared/configEnumDescriptions.ts
+var byKey = {
+  "advice.include": adviceFragmentTitles,
+  "advice.exclude": adviceFragmentTitles
+};
+function configEnumDescriptions(key) {
+  return byKey[key];
+}
+
+// src/shared/formatConfigPath.ts
+var RECORD_ENTRY_TOKEN = "*";
+function segmentText(segment) {
+  if (segment.kind === "key") return segment.name;
+  if (segment.kind === "entry") return RECORD_ENTRY_TOKEN;
+  if (segment.kind === "index") return `[${segment.index}]`;
+  return "[]";
+}
+function formatConfigPath(path91) {
+  let text18 = "";
+  for (const segment of path91) {
+    const dotted = segment.kind === "key" || segment.kind === "entry";
+    const rendered = segmentText(segment);
+    text18 += dotted && text18 ? `.${rendered}` : rendered;
+  }
+  return text18;
+}
+
 // src/shared/unwrapSchemaNode.ts
 var WRAPPER_TYPES = /* @__PURE__ */ new Set([
   "optional",
@@ -2911,7 +2959,9 @@ function scalarArrayItemType(node) {
 function scalarListNode(inner, base, item) {
   const itemType = scalarArrayItemType(inner);
   if (!itemType || item.kind !== "scalar") return void 0;
-  return { ...base, kind: "scalarList", itemType, item };
+  const descriptions = configEnumDescriptions(formatConfigPath(base.path));
+  const described = descriptions && item.enumValues ? { ...item, enumDescriptions: descriptions } : item;
+  return { ...base, kind: "scalarList", itemType, item: described };
 }
 function objectListNode(base, item) {
   if (item.kind !== "object" && item.kind !== "unionOfObjects")
@@ -2995,24 +3045,6 @@ function describeConfigNode(schema2) {
   return build(schema2, []);
 }
 
-// src/shared/formatConfigPath.ts
-var RECORD_ENTRY_TOKEN = "*";
-function segmentText(segment) {
-  if (segment.kind === "key") return segment.name;
-  if (segment.kind === "entry") return RECORD_ENTRY_TOKEN;
-  if (segment.kind === "index") return `[${segment.index}]`;
-  return "[]";
-}
-function formatConfigPath(path91) {
-  let text18 = "";
-  for (const segment of path91) {
-    const dotted = segment.kind === "key" || segment.kind === "entry";
-    const rendered = segmentText(segment);
-    text18 += dotted && text18 ? `.${rendered}` : rendered;
-  }
-  return text18;
-}
-
 // src/shared/describeConfigLeaves.ts
 function leafType(node) {
   switch (node.kind) {
@@ -5377,8 +5409,11 @@ function explainAdvice(context, fragments = loadAdviceFragments()) {
   const width = Math.max(
     ...decisions.map((decision) => decision.fragment.name.length)
   );
+  const titleWidth = Math.max(
+    ...decisions.map((decision) => decision.fragment.title.length)
+  );
   return decisions.map(
-    ({ fragment, included, reason: reason4 }) => `${included ? chalk28.green("\u2713") : chalk28.dim("\u2717")} ${fragment.name.padEnd(width)}  ${reason4}`
+    ({ fragment, included, reason: reason4 }) => `${included ? chalk28.green("\u2713") : chalk28.dim("\u2717")} ${fragment.name.padEnd(width)}  ${chalk28.dim(fragment.title.padEnd(titleWidth))}  ${reason4}`
   ).join("\n");
 }
 
@@ -11524,10 +11559,10 @@ function configEntryNode(root, key) {
 }
 
 // src/commands/config/configHelpForKey.ts
-var byKey;
+var byKey2;
 function configHelpForKey(key) {
-  byKey ??= new Map(configHelpEntries.map((entry) => [entry.key, entry]));
-  return byKey.get(key);
+  byKey2 ??= new Map(configHelpEntries.map((entry) => [entry.key, entry]));
+  return byKey2.get(key);
 }
 
 // src/commands/config/isGlobalOnlyConfigKey.ts

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@staff0rd/assist",
-	"version": "0.659.1",
+	"version": "0.660.0",
 	"type": "module",
 	"main": "dist/index.js",
 	"bin": {