@thinkingsage/kanon 0.8.0

package/src/rosetta/builtins/pretty-printers/kiro-power.ts

@@ -0,0 +1,108 @@
+/**
+ * Rosetta Stone — Kiro Power Pretty-Printer
+ *
+ * Renders a canonical KnowledgeArtifact back into the kiro-power source format:
+ * - `POWER.md` with YAML frontmatter (name, description, keywords, globs, alwaysApply)
+ * - `steering/*.md` from workflows
+ *
+ * CONSTRAINTS:
+ * - NO filesystem, process, clock, random, Git, or network imports
+ * - Pure function only
+ *
+ * Requirements: 5.4, 12.4, 16.2
+ */
+
+import type {
+	NormalizedRelativePath,
+	SourceDocument,
+	TranslationDiagnostic,
+} from "../../../schemas";
+import { renderDeterministicYaml } from "../../canonical";
+import { codePointCompare } from "../../contracts";
+import type {
+	SourcePrintOutput,
+	SourceTranslatorContext,
+} from "../../registry";
+
+// ═══════════════════════════════════════════════════════════════════════════════
+// Pretty-Printer
+// ═══════════════════════════════════════════════════════════════════════════════
+
+/**
+ * Pretty-print a canonical KnowledgeArtifact into kiro-power source format.
+ *
+ * Produces:
+ * - `POWER.md` with frontmatter: name, description, keywords, globs (from file_patterns),
+ *   alwaysApply (from inclusion)
+ * - `steering/*.md` from workflows
+ */
+export function prettyPrintKiroPower(
+	artifact: Record<string, unknown>,
+	_context: SourceTranslatorContext,
+): SourcePrintOutput {
+	const diagnostics: TranslationDiagnostic[] = [];
+	const documents: SourceDocument[] = [];
+
+	const fm = (artifact.frontmatter ?? {}) as Record<string, unknown>;
+	const body = (artifact.body as string) ?? "";
+	const workflows =
+		(artifact.workflows as Array<{
+			name: string;
+			filename: string;
+			content: string;
+		}>) ?? [];
+
+	// Build POWER.md frontmatter
+	const powerFm: Record<string, unknown> = {};
+
+	if (fm.name) powerFm.name = fm.name;
+	if (fm.description) powerFm.description = fm.description;
+	if (Array.isArray(fm.keywords) && fm.keywords.length > 0) {
+		powerFm.keywords = fm.keywords;
+	}
+
+	// Map file_patterns → globs
+	if (Array.isArray(fm.file_patterns) && fm.file_patterns.length > 0) {
+		powerFm.globs = fm.file_patterns;
+	}
+
+	// Map inclusion → alwaysApply
+	if (fm.inclusion === "always") {
+		powerFm.alwaysApply = true;
+	} else if (fm.inclusion && fm.inclusion !== "manual") {
+		powerFm.inclusion = fm.inclusion;
+	}
+
+	// Render POWER.md
+	const POWER_KEY_ORDER = [
+		"name",
+		"description",
+		"keywords",
+		"globs",
+		"alwaysApply",
+		"inclusion",
+	];
+	const frontmatterYaml = renderDeterministicYaml(powerFm, POWER_KEY_ORDER);
+	const powerContent = `---\n${frontmatterYaml}---\n${body}\n`;
+
+	documents.push({
+		path: "POWER.md" as NormalizedRelativePath,
+		content: powerContent,
+		executable: false,
+	});
+
+	// Render steering/*.md from workflows
+	const sortedWorkflows = [...workflows].sort((a, b) =>
+		codePointCompare(a.filename, b.filename),
+	);
+
+	for (const wf of sortedWorkflows) {
+		documents.push({
+			path: `steering/${wf.filename}` as NormalizedRelativePath,
+			content: `${wf.content}\n`,
+			executable: false,
+		});
+	}
+
+	return { documents, diagnostics };
+}

package/src/rosetta/builtins/pretty-printers/kiro-skill.ts

@@ -0,0 +1,88 @@
+/**
+ * Rosetta Stone — Kiro Skill Pretty-Printer
+ *
+ * Renders a canonical KnowledgeArtifact back into the kiro-skill source format:
+ * - `SKILL.md` with YAML frontmatter (name, description, keywords)
+ * - `references/*.md` from workflows
+ *
+ * CONSTRAINTS:
+ * - NO filesystem, process, clock, random, Git, or network imports
+ * - Pure function only
+ *
+ * Requirements: 5.4, 12.4, 16.2
+ */
+
+import type {
+	NormalizedRelativePath,
+	SourceDocument,
+	TranslationDiagnostic,
+} from "../../../schemas";
+import { renderDeterministicYaml } from "../../canonical";
+import { codePointCompare } from "../../contracts";
+import type {
+	SourcePrintOutput,
+	SourceTranslatorContext,
+} from "../../registry";
+
+// ═══════════════════════════════════════════════════════════════════════════════
+// Pretty-Printer
+// ═══════════════════════════════════════════════════════════════════════════════
+
+/**
+ * Pretty-print a canonical KnowledgeArtifact into kiro-skill source format.
+ *
+ * Produces:
+ * - `SKILL.md` with frontmatter: name, description, keywords
+ * - `references/*.md` from workflows
+ */
+export function prettyPrintKiroSkill(
+	artifact: Record<string, unknown>,
+	_context: SourceTranslatorContext,
+): SourcePrintOutput {
+	const diagnostics: TranslationDiagnostic[] = [];
+	const documents: SourceDocument[] = [];
+
+	const fm = (artifact.frontmatter ?? {}) as Record<string, unknown>;
+	const body = (artifact.body as string) ?? "";
+	const workflows =
+		(artifact.workflows as Array<{
+			name: string;
+			filename: string;
+			content: string;
+		}>) ?? [];
+
+	// Build SKILL.md frontmatter
+	const skillFm: Record<string, unknown> = {};
+
+	if (fm.name) skillFm.name = fm.name;
+	if (fm.description) skillFm.description = fm.description;
+	if (Array.isArray(fm.keywords) && fm.keywords.length > 0) {
+		skillFm.keywords = fm.keywords;
+	}
+
+	// Render SKILL.md
+	const SKILL_KEY_ORDER = ["name", "description", "keywords"];
+	const frontmatterYaml = renderDeterministicYaml(skillFm, SKILL_KEY_ORDER);
+	const skillContent = `---\n${frontmatterYaml}---\n${body}\n`;
+
+	documents.push({
+		path: "SKILL.md" as NormalizedRelativePath,
+		content: skillContent,
+		executable: false,
+	});
+
+	// Render references/*.md from workflows
+	const sortedWorkflows = [...workflows].sort((a, b) =>
+		codePointCompare(a.filename, b.filename),
+	);
+
+	for (const wf of sortedWorkflows) {
+		documents.push({
+			path: `references/${wf.filename}` as NormalizedRelativePath,
+			content: `${wf.content}\n`,
+			executable: false,
+		});
+	}
+
+	return { documents, diagnostics };
+}

package/src/rosetta/builtins/pretty-printers/qdeveloper-native.ts

@@ -0,0 +1,51 @@
+/**
+ * Rosetta Stone — Q Developer Native Pretty-Printer
+ *
+ * Renders a canonical KnowledgeArtifact back into Q Developer native format:
+ * - `.qdeveloper/rules/<name>.md` with body content
+ *
+ * CONSTRAINTS:
+ * - NO filesystem, process, clock, random, Git, or network imports
+ * - Pure function only
+ *
+ * Requirements: 5.4, 12.4, 16.2
+ */
+
+import type {
+	NormalizedRelativePath,
+	SourceDocument,
+	TranslationDiagnostic,
+} from "../../../schemas";
+import type {
+	SourcePrintOutput,
+	SourceTranslatorContext,
+} from "../../registry";
+
+// ═══════════════════════════════════════════════════════════════════════════════
+// Pretty-Printer
+// ═══════════════════════════════════════════════════════════════════════════════
+
+/**
+ * Pretty-print a canonical KnowledgeArtifact into Q Developer native format.
+ *
+ * Produces:
+ * - `.qdeveloper/rules/<name>.md` with the artifact body
+ */
+export function prettyPrintQDeveloperNative(
+	artifact: Record<string, unknown>,
+	_context: SourceTranslatorContext,
+): SourcePrintOutput {
+	const diagnostics: TranslationDiagnostic[] = [];
+	const documents: SourceDocument[] = [];
+
+	const body = (artifact.body as string) ?? "";
+	const name = (artifact.name as string) ?? "rule";
+
+	documents.push({
+		path: `.qdeveloper/rules/${name}.md` as NormalizedRelativePath,
+		content: `${body}\n`,
+		executable: false,
+	});
+
+	return { documents, diagnostics };
+}

package/src/rosetta/builtins/pretty-printers/superpowers.ts

@@ -0,0 +1,97 @@
+/**
+ * Rosetta Stone — Superpowers Pretty-Printer
+ *
+ * Renders a canonical KnowledgeArtifact back into the superpowers source format:
+ * - `SKILL.md` with YAML frontmatter (name, description, requires from depends)
+ * - Companion `.md` files from workflows
+ *
+ * CONSTRAINTS:
+ * - NO filesystem, process, clock, random, Git, or network imports
+ * - Pure function only
+ *
+ * Requirements: 5.4, 12.4, 16.2
+ */
+
+import type {
+	NormalizedRelativePath,
+	SourceDocument,
+	TranslationDiagnostic,
+} from "../../../schemas";
+import { renderDeterministicYaml } from "../../canonical";
+import { codePointCompare } from "../../contracts";
+import type {
+	SourcePrintOutput,
+	SourceTranslatorContext,
+} from "../../registry";
+
+// ═══════════════════════════════════════════════════════════════════════════════
+// Pretty-Printer
+// ═══════════════════════════════════════════════════════════════════════════════
+
+/**
+ * Pretty-print a canonical KnowledgeArtifact into superpowers source format.
+ *
+ * Produces:
+ * - `SKILL.md` with frontmatter: name, description, requires (from depends)
+ * - Companion `.md` files from workflows
+ */
+export function prettyPrintSuperpowers(
+	artifact: Record<string, unknown>,
+	_context: SourceTranslatorContext,
+): SourcePrintOutput {
+	const diagnostics: TranslationDiagnostic[] = [];
+	const documents: SourceDocument[] = [];
+
+	const fm = (artifact.frontmatter ?? {}) as Record<string, unknown>;
+	const body = (artifact.body as string) ?? "";
+	const workflows =
+		(artifact.workflows as Array<{
+			name: string;
+			filename: string;
+			content: string;
+		}>) ?? [];
+
+	// Build SKILL.md frontmatter
+	const skillFm: Record<string, unknown> = {};
+
+	if (fm.name) skillFm.name = fm.name;
+	if (fm.description) skillFm.description = fm.description;
+
+	// Map depends → requires
+	if (Array.isArray(fm.depends) && fm.depends.length > 0) {
+		skillFm.requires = fm.depends;
+	}
+
+	if (Array.isArray(fm.keywords) && fm.keywords.length > 0) {
+		skillFm.keywords = fm.keywords;
+	}
+
+	// Render SKILL.md
+	const SUPERPOWERS_KEY_ORDER = ["name", "description", "requires", "keywords"];
+	const frontmatterYaml = renderDeterministicYaml(
+		skillFm,
+		SUPERPOWERS_KEY_ORDER,
+	);
+	const skillContent = `---\n${frontmatterYaml}---\n${body}\n`;
+
+	documents.push({
+		path: "SKILL.md" as NormalizedRelativePath,
+		content: skillContent,
+		executable: false,
+	});
+
+	// Render companion .md files from workflows
+	const sortedWorkflows = [...workflows].sort((a, b) =>
+		codePointCompare(a.filename, b.filename),
+	);
+
+	for (const wf of sortedWorkflows) {
+		documents.push({
+			path: wf.filename as NormalizedRelativePath,
+			content: `${wf.content}\n`,
+			executable: false,
+		});
+	}
+
+	return { documents, diagnostics };
+}

package/src/rosetta/builtins/pretty-printers/windsurf-native.ts

@@ -0,0 +1,50 @@
+/**
+ * Rosetta Stone — Windsurf Native Pretty-Printer
+ *
+ * Renders a canonical KnowledgeArtifact back into Windsurf native format:
+ * - `.windsurfrules` with body content
+ *
+ * CONSTRAINTS:
+ * - NO filesystem, process, clock, random, Git, or network imports
+ * - Pure function only
+ *
+ * Requirements: 5.4, 12.4, 16.2
+ */
+
+import type {
+	NormalizedRelativePath,
+	SourceDocument,
+	TranslationDiagnostic,
+} from "../../../schemas";
+import type {
+	SourcePrintOutput,
+	SourceTranslatorContext,
+} from "../../registry";
+
+// ═══════════════════════════════════════════════════════════════════════════════
+// Pretty-Printer
+// ═══════════════════════════════════════════════════════════════════════════════
+
+/**
+ * Pretty-print a canonical KnowledgeArtifact into Windsurf native format.
+ *
+ * Produces:
+ * - `.windsurfrules` with the artifact body
+ */
+export function prettyPrintWindsurfNative(
+	artifact: Record<string, unknown>,
+	_context: SourceTranslatorContext,
+): SourcePrintOutput {
+	const diagnostics: TranslationDiagnostic[] = [];
+	const documents: SourceDocument[] = [];
+
+	const body = (artifact.body as string) ?? "";
+
+	documents.push({
+		path: ".windsurfrules" as NormalizedRelativePath,
+		content: `${body}\n`,
+		executable: false,
+	});
+
+	return { documents, diagnostics };
+}