@nseng-ai/plans 0.1.1 → 0.1.2

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@nseng-ai/plans",
-	"version": "0.1.1",
+	"version": "0.1.2",
 	"type": "module",
 	"files": [
 		"src"
@@ -21,9 +21,9 @@
 		"./testing": "./src/testing.ts"
 	},
 	"dependencies": {
-		"@nseng-ai/capability-kit": "0.1.1",
-		"@nseng-ai/clinkr": "0.1.1",
-		"@nseng-ai/foundation": "0.1.1",
+		"@nseng-ai/capability-kit": "0.1.2",
+		"@nseng-ai/clinkr": "0.1.2",
+		"@nseng-ai/foundation": "0.1.2",
 		"zod": "^4.4.3"
 	}
 }

package/src/content-slug-derivation.ts

@@ -1,12 +1,17 @@
-import { type CommandExecApi, formatOutputSection } from "@nseng-ai/foundation/exec";
-import { deriveSlugWithModel, type SlugModelEvidence } from "@nseng-ai/capability-kit/model-slug";
+import {
+	buildKitContentSlugPrompt,
+	deriveKitContentSlug,
+	normalizeContentSlugOutput,
+	truncateContentForSlug,
+	type ContentSlugEvidence,
+	type KitContentSlugDerivationVariant,
+} from "@nseng-ai/capability-kit/content-slug";
+import type { CommandExecApi } from "@nseng-ai/foundation/exec";
 import { MAX_PLAN_SLUG_WORDS, MIN_PLAN_SLUG_WORDS, validatePlanSlug } from "./plan-persistence.ts";
 
-const MAX_ERROR_CHARS = 4_000;
-
 export const MAX_PLAN_CONTENT_CHARS = 32_000;
 
-export interface ContentSlugDerivationVariant {
+export interface PlanContentSlugVariantSeed {
 	slugKind: string;
 	promptIntroLines: readonly string[];
 	invalidSlugMessage: string;
@@ -20,108 +25,61 @@ export interface DeriveContentSlugInput {
 	signal?: AbortSignal;
 }
 
-export type ContentSlugEvidence = SlugModelEvidence;
+export type { ContentSlugEvidence };
 
 export async function deriveContentSlug(
 	pi: CommandExecApi,
 	input: DeriveContentSlugInput,
-	variant: ContentSlugDerivationVariant,
+	variant: PlanContentSlugVariantSeed,
 ): Promise<ContentSlugEvidence> {
-	const prompt = buildContentSlugPrompt(input.content, variant);
-	const result = await deriveSlugWithModel({
-		cwd: input.cwd,
-		prompt,
-		...(input.signal === undefined ? {} : { signal: input.signal }),
-		slugKind: variant.slugKind,
-		normalizeOutput: normalizePlanContentSlugOutput,
-		exec: (command, args, options) => pi.exec(command, args, options),
-	});
-	if (!result.ok) {
-		throw slugDerivationFailed(variant, result.failure.lines);
-	}
-
-	const { slug, rawOutput } = result.evidence;
-	const slugError = validatePlanSlug(slug);
-	if (slugError !== undefined) {
-		throw slugDerivationFailed(variant, [
-			variant.invalidSlugMessage,
-			`Normalized slug: ${slug}`,
-			`Reason: ${slugError}`,
-			formatOutputSection("stdout", rawOutput, { maxChars: MAX_ERROR_CHARS, maxLines: 80 }),
-		]);
-	}
-
-	return result.evidence;
+	return deriveKitContentSlug(
+		{ exec: (command, args, options) => pi.exec(command, args, options) },
+		input,
+		toKitContentSlugVariant(variant),
+	);
 }
 
 export function buildContentSlugPrompt(
 	content: string,
-	variant: ContentSlugDerivationVariant,
+	variant: PlanContentSlugVariantSeed,
 ): string {
-	return [
-		...variant.promptIntroLines,
-		"Return exactly one slug and no prose.",
-		"Rules:",
-		"- Use lowercase ASCII kebab-case words separated by single hyphens.",
-		`- Use ${MIN_PLAN_SLUG_WORDS}–${MAX_PLAN_SLUG_WORDS} words.`,
-		"- Make the slug specific to the implementation described by the plan.",
-		"- Prefer concrete deliverables and nouns from the plan body.",
-		"- Do not use dates, random IDs, generic-only slugs, or the saved-plan filename.",
-		"",
-		"## Plan content",
-		truncatePlanContentForSlug(displayPlanContentForSlug(content)),
-	].join("\n");
+	return buildKitContentSlugPrompt(content, toKitContentSlugVariant(variant));
 }
 
-function displayPlanContentForSlug(content: string): string {
-	const trimmed = content.trim();
-	return trimmed.length > 0 ? trimmed : "(empty plan content)";
-}
+const PLAN_CONTENT_SLUG_NORMALIZATION = {
+	maxWords: MAX_PLAN_SLUG_WORDS,
+	stripSuffixes: ["-plan"],
+} satisfies KitContentSlugDerivationVariant["normalization"];
 
-export function normalizePlanContentSlugOutput(value: string): string | undefined {
-	const firstLine = firstNonEmptyModelOutputLine(value);
-	if (firstLine === undefined) {
-		return undefined;
-	}
+const PLAN_CONTENT_SLUG_TRUNCATION = {
+	maxContentChars: MAX_PLAN_CONTENT_CHARS,
+	truncationMessage: "[Plan content truncated for slug generation]",
+} satisfies Pick<KitContentSlugDerivationVariant, "maxContentChars" | "truncationMessage">;
 
-	const slug = firstLine
-		.toLowerCase()
-		.normalize("NFKD")
-		.replace(/[\u0300-\u036f]/g, "")
-		.replace(/[^a-z0-9]+/g, "-")
-		.replace(/-+/g, "-")
-		.replace(/^-|-$/g, "");
-	const withoutPlanSuffix = slug.replace(/(?:-plan)+$/g, "").replace(/^-|-$/g, "");
-	if (withoutPlanSuffix.length === 0) {
-		return undefined;
-	}
-
-	const repaired = withoutPlanSuffix
-		.split("-")
-		.filter(Boolean)
-		.slice(0, MAX_PLAN_SLUG_WORDS)
-		.join("-");
-	return repaired.length > 0 ? repaired : undefined;
+export function normalizePlanContentSlugOutput(value: string): string | undefined {
+	return normalizeContentSlugOutput(value, PLAN_CONTENT_SLUG_NORMALIZATION);
 }
 
 export function truncatePlanContentForSlug(content: string): string {
-	if (content.length <= MAX_PLAN_CONTENT_CHARS) {
-		return content;
-	}
-	return `${content.slice(0, MAX_PLAN_CONTENT_CHARS)}\n\n[Plan content truncated for slug generation]`;
-}
-
-function firstNonEmptyModelOutputLine(value: string): string | undefined {
-	return value
-		.replace(/```[\s\S]*?```/g, (match) => match.replace(/```[a-zA-Z]*\n?|```/g, ""))
-		.split("\n")
-		.map((line) => line.trim())
-		.find((line) => line.length > 0);
+	return truncateContentForSlug(content, PLAN_CONTENT_SLUG_TRUNCATION);
 }
 
-function slugDerivationFailed(
-	variant: ContentSlugDerivationVariant,
-	lines: readonly string[],
-): Error {
-	return new Error([variant.failureHeader, ...lines, variant.noFallbackLine].join("\n"));
+function toKitContentSlugVariant(
+	variant: PlanContentSlugVariantSeed,
+): KitContentSlugDerivationVariant {
+	return {
+		...variant,
+		promptRuleLines: [
+			"- Use lowercase ASCII kebab-case words separated by single hyphens.",
+			`- Use ${MIN_PLAN_SLUG_WORDS}–${MAX_PLAN_SLUG_WORDS} words.`,
+			"- Make the slug specific to the implementation described by the plan.",
+			"- Prefer concrete deliverables and nouns from the plan body.",
+			"- Do not use dates, random IDs, generic-only slugs, or the saved-plan filename.",
+		],
+		contentHeading: "## Plan content",
+		emptyContentPlaceholder: "(empty plan content)",
+		...PLAN_CONTENT_SLUG_TRUNCATION,
+		normalization: PLAN_CONTENT_SLUG_NORMALIZATION,
+		validateSlug: validatePlanSlug,
+	};
 }

package/src/index.ts

@@ -5,7 +5,7 @@ export {
 	MAX_PLAN_CONTENT_CHARS,
 	normalizePlanContentSlugOutput,
 	truncatePlanContentForSlug,
-	type ContentSlugDerivationVariant,
+	type PlanContentSlugVariantSeed,
 	type ContentSlugEvidence,
 	type DeriveContentSlugInput,
 } from "./content-slug-derivation.ts";

package/src/saved-plan-content-slug.ts

@@ -2,13 +2,13 @@ import type { CommandExecApi } from "@nseng-ai/foundation/exec";
 import {
 	buildContentSlugPrompt,
 	deriveContentSlug,
-	type ContentSlugDerivationVariant,
+	type PlanContentSlugVariantSeed,
 	type ContentSlugEvidence,
 } from "./content-slug-derivation.ts";
 
 export type SavedPlanContentSlugEvidence = ContentSlugEvidence;
 
-const SAVED_PLAN_CONTENT_SLUG_VARIANT: ContentSlugDerivationVariant = {
+const SAVED_PLAN_CONTENT_SLUG_VARIANT: PlanContentSlugVariantSeed = {
 	slugKind: "saved-plan filename slug",
 	promptIntroLines: [
 		"Generate the saved-plan filename slug for the Markdown implementation plan content below.",