chore(readme): Expand README with detailed configuration docs

[eddyv]

Improves environment schema

• Adds detailed configuration/usage sections
• Creates dedicated env schema module
• Adds schema to markdown generator tool
• Includes instructional screenshots/gifs
• Updates config validation types

[Copilot]

Copilot reviewed 8 out of 9 changed files in this pull request and generated 1 comment.

Files not reviewed (1)

• package.json: Language not supported

Comments suppressed due to low confidence (5)

src/print-md-schema.ts:55

• The formatTableRow function should handle cases where schema.description is not present. Consider adding a fallback or default description.

let description = (schema as any).description || '';

src/print-md-schema.ts:93

• [nitpick] The getTypeInfo function could provide a more descriptive enum type by including the type of enum values.

if (schema instanceof z.ZodEnum) return `enum: ${schema.options.join(' | ')}`;

src/env-schema.ts:55

• The description for CONFIG_PATH mentions 'Future Implementation', which might be confusing. Consider rephrasing to clarify the current state of implementation.

.describe("File system path to store and retrieve conversation-based configurations for session persistence (Future Implementation)")

src/env-schema.ts:27

• [nitpick] The description for FLINK_API_KEY is too verbose. Consider shortening to 'Authentication key for accessing Confluent Cloud's Flink services'.

.describe("Authentication key for accessing Confluent Cloud's Flink services, including compute pools and SQL statement management")

src/env-schema.ts:35

• [nitpick] The description for FLINK_API_SECRET is too verbose. Consider shortening to 'Secret token for accessing Confluent Cloud's Flink services'.

.describe("Secret token paired with FLINK_API_KEY for authenticated access to Confluent Cloud's Flink services")

[Copilot]

The extractRows function does not account for nested objects within arrays or other complex structures. Consider adding support for these cases.