docs(skill-nudge): document helper contracts

ahndohun · ahndohun · commit df9fbc223b5d · 2026-07-01T17:53:59.000+09:00
diff --git a/src/lib/skill-nudge.ts b/src/lib/skill-nudge.ts
@@ -70,6 +70,7 @@ export function isVerifySkillInstalled(dir: string, deps: SkillPresenceDeps = {}
   return false;
 }
 
+/** True when a managed-section file contains an ordered TestSprite BEGIN/END pair. */
 function hasCompleteManagedSection(content: string): boolean {
   const begin = content.indexOf(MANAGED_SECTION_BEGIN);
   if (begin === -1) return false;
@@ -140,6 +141,7 @@ export function maybeEmitSkillNudge(ctx: SkillNudgeContext): void {
   }
 }
 
+/** Interpret common env-var spellings for an enabled opt-out flag. */
 function isTruthyEnv(v: string | undefined): boolean {
   if (v === undefined) return false;
   const s = v.trim().toLowerCase();

Original file line number	Diff line number	Diff line change
`@@ -70,6 +70,7 @@ export function isVerifySkillInstalled(dir: string, deps: SkillPresenceDeps = {}`
`70`	`70`	`return false;`
`71`	`71`	`}`
`72`	`72`
	`73`	`+/** True when a managed-section file contains an ordered TestSprite BEGIN/END pair. */`
`73`	`74`	`function hasCompleteManagedSection(content: string): boolean {`
`74`	`75`	`const begin = content.indexOf(MANAGED_SECTION_BEGIN);`
`75`	`76`	`if (begin === -1) return false;`
`@@ -140,6 +141,7 @@ export function maybeEmitSkillNudge(ctx: SkillNudgeContext): void {`
`140`	`141`	`}`
`141`	`142`	`}`
`142`	`143`
	`144`	`+/** Interpret common env-var spellings for an enabled opt-out flag. */`
`143`	`145`	`function isTruthyEnv(v: string \| undefined): boolean {`
`144`	`146`	`if (v === undefined) return false;`
`145`	`147`	`const s = v.trim().toLowerCase();`