feat: refactor rules generation to ai-context with skill output

Rename src/rules to src/ai-context and enhance the context generation:
- Extract example configs to separate context.ts module with doc references
- Generate both checkly.rules.md and skills/monitoring/SKILL.md
- Add YAML frontmatter for skill metadata (stripped from rules output)
- Support inline exampleConfig in addition to exampleConfigPath

Author: stefanjudis

packages/cli/package.json

@@ -18,9 +18,9 @@
     "clean:gen": "rimraf ./gen",
     "clean": "npm run clean:dist && npm run clean:gen",
     "prepack": "npx oclif manifest",
-    "generate:rules": "cross-env CHECKLY_SKIP_AUTH=1 CHECKLY_CLI_VERSION=99.0.0 ./bin/run import plan --root gen --debug-import-plan-input-file ./src/rules/rules.fixtures.json && ts-node ./scripts/compile-rules.ts",
+    "generate:ai-context": "cross-env CHECKLY_SKIP_AUTH=1 CHECKLY_CLI_VERSION=99.0.0 ./bin/run import plan --root gen --debug-import-plan-input-file ./src/ai-context/context.fixtures.json && ts-node ./scripts/compile-ai-context.ts",
     "prepare:dist": "tsc --build",
-    "prepare": "npm run clean && npm run prepare:dist && npm run generate:rules",
+    "prepare": "npm run clean && npm run prepare:dist && npm run generate:ai-context",
     "test": "vitest",
     "test:e2e": "npm run prepare && cross-env NODE_CONFIG_DIR=./e2e/config vitest -c ./vitest.config.e2e.mts",
     "test:e2e:local": "cross-env CHECKLY_BASE_URL=http://localhost:3000  CHECKLY_ENV=local npm run test:e2e",

packages/cli/scripts/compile-ai-context.ts

@@ -0,0 +1,88 @@
+// ABOUTME: Compiles the context template with code examples into rules and skill outputs.
+// ABOUTME: Generates dist/ai-context/checkly.rules.md and skills/monitoring/SKILL.md
+
+import { mkdir, readFile, writeFile } from 'fs/promises'
+import { join } from 'path'
+import { EXAMPLE_CONFIGS } from '../src/ai-context/context'
+
+const EXAMPLES_DIR = join(__dirname, '../gen/')
+const CONTEXT_TEMPLATE_PATH = join(
+  __dirname,
+  '../src/ai-context/checkly.context.template.md',
+)
+const RULES_OUTPUT_DIR = join(__dirname, '../dist/ai-context')
+const SKILL_OUTPUT_DIR = join(__dirname, '../../../skills/monitoring')
+
+function stripYamlFrontmatter (content: string): string {
+  const frontmatterRegex = /^---\n[\s\S]*?\n---\n+/
+  return content.replace(frontmatterRegex, '')
+}
+
+async function writeOutput (content: string, dir: string, filename: string): Promise<void> {
+  await mkdir(dir, { recursive: true })
+  const outputPath = join(dir, filename)
+  await writeFile(outputPath, content, 'utf8')
+  // eslint-disable-next-line no-console
+  console.log(`✅ Compiled to ${outputPath}`)
+}
+
+async function compileContext () {
+  try {
+    // eslint-disable-next-line no-console
+    console.log('📝 Compiling context template with examples...')
+
+    let content = await readFile(CONTEXT_TEMPLATE_PATH, 'utf8')
+    const examples = await readExampleCode()
+
+    for (const example of examples) {
+      content = content.replace(example.templateString, example.code)
+    }
+
+    await writeOutput(content, SKILL_OUTPUT_DIR, 'SKILL.md')
+    await writeOutput(
+      stripYamlFrontmatter(content),
+      RULES_OUTPUT_DIR,
+      'checkly.rules.md',
+    )
+  } catch (error) {
+    // eslint-disable-next-line no-console
+    console.error('❌ Failed to compile context:', error)
+    process.exit(1)
+  }
+}
+
+async function readExampleCode (): Promise<
+  { templateString: string, code: string }[]
+> {
+  const examples: { templateString: string, code: string }[] = []
+
+  for (const config of Object.values(EXAMPLE_CONFIGS)) {
+    let code: string | undefined
+
+    if (config.exampleConfig) {
+      code = config.exampleConfig
+    } else if (config.exampleConfigPath) {
+      const filePath = join(EXAMPLES_DIR, config.exampleConfigPath)
+      try {
+        code = await readFile(filePath, 'utf8')
+      } catch {
+        // eslint-disable-next-line no-console
+        console.warn(
+          `Warning: Could not read example for ${config.templateString} from ${filePath}. It might not exist or be accessible.`,
+        )
+      }
+    }
+
+    if (code) {
+      const wrappedCode = `**Reference:** ${config.reference}\n\n\`\`\`typescript\n${code}\`\`\``
+      examples.push({
+        templateString: config.templateString,
+        code: wrappedCode,
+      })
+    }
+  }
+
+  return examples
+}
+
+compileContext()