ప్రధాన కంటెంట్‌కి దాటవేయండి

తెలిసిన ఆశ్చర్యాలు

ఈ ఫైల్ ఏజెంట్ తప్పులకు కారణమైన రిపోజిటరీ-నిర్దిష్ట గందరగోళ పాయింట్‌లను ట్రాక్ చేస్తుంది.

ప్రవేశ ప్రమాణాలు​

అన్నీ నిజమైతే మాత్రమే ఎంట్రీని జోడించండి:

  • ఇది ఈ రిపోజిటరీకి ప్రత్యేకమైనది (సాధారణ సలహా కాదు).
  • భవిష్యత్ ఏజెంట్లకు ఇది పునరావృతమయ్యే అవకాశం ఉంది.
  • ఇది అనుసరించదగిన కాంక్రీటు ఉపశమనాన్ని కలిగి ఉంది.

అనిశ్చితంగా ఉంటే, ఎంట్రీని జోడించే ముందు డెవలపర్‌ని అడగండి.

ఎంట్రీ టెంప్లేట్​

### [Short title]

- **Date:** YYYY-MM-DD
- **Observed by:** agent name or contributor
- **Context:** where/when it happened
- **What was surprising:** concrete unexpected behavior
- **Impact:** what went wrong or could go wrong
- **Mitigation:** exact step future agents should take
- **Status:** confirmed | superseded

ఎంట్రీలు​

పోర్ట్‌లెస్ నియమానుగుణ స్థానిక యాప్ URLని మారుస్తుంది​

  • తేదీ: 2026-03-18
  • ** పరిశీలించినవారు:** కోడెక్స్
  • సందర్భం: బ్రౌజర్ ధృవీకరణ మరియు పొగ ప్రవహిస్తుంది
  • ఆశ్చర్యకరమైన విషయం: డిఫాల్ట్ స్థానిక URL సాధారణ Vite పోర్ట్ కాదు. Repo పోర్ట్‌లెస్ ద్వారా https://bitsocial.localhostని ఆశించింది, కాబట్టి localhost:3000 లేదా localhost:5173ని తనిఖీ చేయడం వలన తప్పు యాప్ లేదా ఏమీ తగలదు.
  • ప్రభావం: డెవ్ సర్వర్ ఆరోగ్యంగా ఉన్నప్పుడు కూడా బ్రౌజర్ తనిఖీలు విఫలమవుతాయి లేదా తప్పు లక్ష్యాన్ని ధృవీకరించవచ్చు.
  • తగ్గింపు: ముందుగా https://bitsocial.localhostని ఉపయోగించండి. మీకు ప్రత్యక్ష Vite పోర్ట్ అవసరమైనప్పుడు మాత్రమే PORTLESS=0 corepack yarn startతో బైపాస్ చేయండి.
  • స్థితి: ధృవీకరించబడింది

కమిటిజెన్ హుక్స్ నాన్-ఇంటరాక్టివ్ కమిట్‌లను బ్లాక్ చేస్తాయి​

  • తేదీ: 2026-03-18
  • ** పరిశీలించినవారు:** కోడెక్స్
  • సందర్భం: ఏజెంట్ నడిచే కమిట్ వర్క్‌ఫ్లోలు
  • ఆశ్చర్యకరమైన విషయం ఏమిటంటే: git commit హస్కీ ద్వారా కమిటిజెన్‌ని ట్రిగ్గర్ చేస్తుంది మరియు ఇంటరాక్టివ్ TTY ఇన్‌పుట్ కోసం వేచి ఉంది, ఇది ఇంటరాక్టివ్ కాని ఏజెంట్ షెల్‌లను వేలాడదీస్తుంది.
  • ప్రభావం: సాధారణ నిబద్ధత సమయంలో ఏజెంట్లు నిరవధికంగా నిలిచిపోవచ్చు.
  • మిటిగేషన్: ఏజెంట్ సృష్టించిన కమిట్‌ల కోసం git commit --no-verify -m "message"ని ఉపయోగించండి. మానవులు ఇప్పటికీ corepack yarn commit లేదా corepack yarn exec czని ఉపయోగించవచ్చు.
  • స్థితి: ధృవీకరించబడింది

నూలు క్లాసిక్‌ని నివారించడానికి కోర్‌ప్యాక్ అవసరం​

  • తేదీ: 2026-03-19
  • ** పరిశీలించినవారు:** కోడెక్స్
  • సందర్భం: నూలు 4కి ప్యాకేజీ మేనేజర్ మైగ్రేషన్
  • ఆశ్చర్యకరమైన విషయం ఏమిటంటే: మెషీన్ ఇప్పటికీ PATHలో గ్లోబల్ యార్న్ క్లాసిక్ ఇన్‌స్టాల్‌ను కలిగి ఉంది, కాబట్టి సాదా yarnని అమలు చేయడం ద్వారా పిన్ చేసిన నూలు 4 వెర్షన్‌కు బదులుగా v1కి పరిష్కరించవచ్చు.
  • ప్రభావం: డెవలపర్‌లు అనుకోకుండా రెపో యొక్క ప్యాకేజీ-నిర్వాహక పిన్నింగ్‌ను దాటవేయవచ్చు మరియు విభిన్న ఇన్‌స్టాల్ ప్రవర్తన లేదా లాక్‌ఫైల్ అవుట్‌పుట్‌ను పొందవచ్చు.
  • మిటిగేషన్: షెల్ కమాండ్‌ల కోసం corepack yarn ...ని ఉపయోగించండి లేదా ముందుగా corepack enableని అమలు చేయండి, కాబట్టి సాదా yarn పిన్ చేసిన నూలు 4 వెర్షన్‌కు పరిష్కరిస్తుంది.
  • స్థితి: ధృవీకరించబడింది

బిట్సోషల్ వెబ్ వర్క్‌ట్రీలలో స్థిర పోర్ట్‌లెస్ యాప్ పేర్లు ఢీకొంటాయి​

  • తేదీ: 2026-03-30
  • ** పరిశీలించినవారు:** కోడెక్స్
  • ** సందర్భం:** ఒక Bitsocial వెబ్ వర్క్‌ట్రీలో yarn startని ప్రారంభించడం, మరొక వర్క్‌ట్రీ ఇప్పటికే పోర్ట్‌లెస్ ద్వారా సేవలు అందిస్తోంది
  • ఆశ్చర్యకరమైన విషయం ఏమిటంటే: ప్రతి వర్క్‌ట్రీలో లిటరల్ పోర్ట్‌లెస్ యాప్ పేరు bitsocialని ఉపయోగించడం వలన బ్యాకింగ్ పోర్ట్‌లు వేర్వేరుగా ఉన్నప్పటికీ మార్గమే ఢీకొంటుంది, కాబట్టి bitsocial.localhost ఇప్పటికే నమోదు చేయబడినందున రెండవ ప్రక్రియ విఫలమవుతుంది.
  • ప్రభావం: పోర్ట్‌లెస్ సురక్షితంగా సహజీవనం చేయడానికి ఉద్దేశించినప్పటికీ సమాంతర బిట్సోషల్ వెబ్ బ్రాంచ్‌లు ఒకదానికొకటి బ్లాక్ చేయగలవు.
  • మిటిగేషన్: scripts/start-dev.mjs వెనుక పోర్ట్‌లెస్ స్టార్టప్ ఉంచండి, ఇది ఇప్పుడు కానానికల్ కేస్ వెలుపల బ్రాంచ్-స్కోప్డ్ *.bitsocial.localhost మార్గాన్ని ఉపయోగిస్తుంది మరియు బేర్ bitsocial.localhost పేరు ఇప్పటికే ఆక్రమించబడినప్పుడు బ్రాంచ్-స్కోప్డ్ రూట్‌కి తిరిగి వస్తుంది.
  • స్థితి: ధృవీకరించబడింది

డాక్స్ ప్రివ్యూ హార్డ్-కోడ్ పోర్ట్ 3001కి ఉపయోగించబడుతుంది​

  • తేదీ: 2026-03-30
  • ** పరిశీలించినవారు:** కోడెక్స్
  • ** సందర్భం:** ఇతర స్థానిక రెపోలు మరియు ఏజెంట్‌లతో పాటు yarn startని అమలు చేస్తోంది
  • ఆశ్చర్యకరమైన విషయం ఏమిటంటే: రూట్ dev కమాండ్ docusaurus start --port 3001తో డాక్స్ వర్క్‌స్పేస్‌ను రన్ చేసింది, కాబట్టి ప్రధాన యాప్‌ ఇప్పటికే పోర్ట్‌లెస్‌ని ఉపయోగించినప్పటికీ, మరొక ప్రాసెస్ ఇప్పటికే స్వంతం చేసుకున్న 3001తో మొత్తం dev సెషన్ విఫలమైంది.
  • ప్రభావం: yarn start వెబ్ ప్రాసెస్‌ను బూట్ అయిన వెంటనే నాశనం చేయగలదు, డాక్స్-పోర్ట్ తాకిడి కారణంగా సంబంధం లేని స్థానిక పనికి అంతరాయం కలిగిస్తుంది.
  • మిటిగేషన్: yarn start:docs వెనుక డాక్స్ స్టార్టప్ ఉంచండి, ఇది ఇప్పుడు పోర్ట్‌లెస్ ప్లస్ scripts/start-docs.mjsని ఇంజెక్ట్ చేసిన ఉచిత పోర్ట్‌ను గౌరవించడానికి లేదా నేరుగా అమలు చేసినప్పుడు అందుబాటులో ఉన్న తదుపరి పోర్ట్‌కి తిరిగి వస్తుంది.
  • స్థితి: ధృవీకరించబడింది