[spark-compete] Fix: add Repair guidance when chip-labs root not found in /chip create

[Acone8]

{
"schema": "spark-compete-hotfix-v1",
"event": "spark-compete-first-event",
"submission_mode": "public_repo_pr",
"submission_target_url": "#829",
"team": {
"name": "Syntax Layer",
"members": ["Acone8", "Kruz45", "Dabstil"],
"llm_device_holder": "Acone8",
"device_holder_github": "https://github.com/Acone8",
"github_accounts": ["Acone8", "Kruz45", "Dabstil"]
},
"target_repo": {
"id": "vibeforge1111/spark-telegram-bot",
"source": "https://github.com/vibeforge1111/spark-telegram-bot",
"owner_surface": "telegram-bot"
},
"issue": {
"type": "bug",
"severity": "medium",
"title": "/chip create fails with chip-labs root not found but gives no install guidance",
"actual_behavior": "Sending /chip create a simple note taking app returns Chip create failed: chip-labs root not found: /Users/cyprian/.spark/domain-chip-labs with no guidance on how to fix it.",
"expected_behavior": "When the chip-labs root is missing, the error should tell the user that spark-domain-chip-labs is required and point them to agent.sparkswarm.ai for setup instructions.",
"repro_steps": ["Send /chip create a simple note taking app in Telegram.", "Observe: Chip create failed: chip-labs root not found with no repair guidance.", "The spark-domain-chip-labs module is not installed."],
"affected_workflow": "Telegram bot chip creation and user-facing error guidance"
},
"evidence": {
"safe_links_only": true,
"before_after_proof": "Before: /chip create returns chip-labs root not found with no guidance. After fix: error now shows a Repair section telling the user that spark-domain-chip-labs is required and to check agent.sparkswarm.ai for setup instructions. Fix verified in Telegram. Screenshots attached in linked issue.",
"links": ["https://github.com//issues/827"],
"forbidden": ["pdf", "zip", "exe", "unknown downloads", "shortened links", "archives", "binaries", "tokens", "browser cookies", "wallet material", "raw logs", "raw conversations", "raw memory", "raw patches", "private repo maps", "private scoring details"]
},
"proposed_fix": {
"approach": "Added a pre-flight check in createChipFromPrompt in chipCreate.ts that checks if chipLabsRoot exists before running the CLI. If not found, returns an actionable error with a Repair section explaining that spark-domain-chip-labs is required.",
"files_expected": ["src/chipCreate.ts"],
"tests_or_smoke": "Send /chip create a simple note taking app in Telegram with spark-domain-chip-labs not installed and verify the error shows the Repair section with install guidance."
},
"pr": {
"branch": "spark-compete/telegram-bot-chip-create-missing-module-guidance",
"title_prefix": "[spark-compete]",
"author_github": "Acone8",
"body_must_include": ["packet", "team", "pr_author", "repo", "actual_behavior", "expected_behavior", "repro_steps", "before_after_proof", "tests_or_smoke", "duplicate_notes", "risk_notes", "review_claim"],
"url": "#829"
},
"review_claim": {
"impact_claim": "medium",
"evidence_types": ["smoke_test", "redacted_conversation_excerpt"],
"duplicate_notes": "Searched open PRs and issues in vibeforge1111/spark-telegram-bot. No existing PR covers missing repair guidance for chip-labs root not found. Issue #827 documents this specific failure path.",
"risk_notes": "Change adds a pre-flight existsSync check in createChipFromPrompt before running the CLI. No secrets, CI workflows, auth controls, dependency files, or private repo maps changed.",
"review_state_requested": "pr_review"
}
}