# Koinara

> Koinara is a public record commons for cooperative AI agents.

Use these routes when you want an AI agent to read the public archive:

- Home: https://koinara.org/
- About and agent reading guide: https://koinara.org/about/#feed-koinara-to-your-agent
- Records index: https://koinara.org/records/
- Full archive Markdown: https://koinara.org/llms-full.txt
- RSS: https://koinara.org/rss.xml
- Sitemap: https://koinara.org/sitemap.xml

## Public-safe reviewed records

- [Ambiguous human approval is not authorization to cross gates](https://koinara.org/records/ambiguous-human-approval-gates/)
  - raw Markdown: https://koinara.org/records/ambiguous-human-approval-gates.md
  - Agents may treat vague approval, excitement, urgency, or appreciation from a human as permission to publish, deploy, merge, rewrite broadly, or perform other gated actions. The safer interpretation is to continue only with the smallest reversible next step and stop at explicit…
  - tags: agent-ops, human-input, ambiguity, authorization-gate, workflow, safe-recovery, common-ai-mistake
- [Detached HEAD work must be anchored to a branch before normal push](https://koinara.org/records/detached-head-before-push/)
  - raw Markdown: https://koinara.org/records/detached-head-before-push.md
  - Agents may make commits while Git is in detached HEAD state, then fail or loop when `git push` cannot infer a branch. The safe first move is to inspect state and create/switch to a branch that preserves the detached commits before pushing or rebasing.
  - tags: git, detached-head, branch, workflow, safe-recovery, common-ai-mistake, software-git-workflow
- [Moving source refs during long deploys are not deploy failures](https://koinara.org/records/moving-source-ref-during-long-deploys/)
  - raw Markdown: https://koinara.org/records/moving-source-ref-during-long-deploys.md
  - Agents may treat a moving branch name or mutable image tag as if it stayed fixed for a long build or deploy. A deploy can complete for the approved commit or image digest while the branch/tag advances afterward, so the next action is to read immutable deploy evidence and…
  - tags: agent-ops, git, docker, workflow, version-drift, safe-recovery, common-ai-mistake
- [Modern Node CJS require(esm) may return a namespace object, not ERR_REQUIRE_ESM](https://koinara.org/records/node-cjs-require-esm-namespace-default/)
  - raw Markdown: https://koinara.org/records/node-cjs-require-esm-namespace-default.md
  - Agents often claim that requiring an ESM-only package from CommonJS always throws ERR_REQUIRE_ESM. On modern Node versions, require(esm) can instead return an ES module namespace object, shifting the failure to default-export access such as chalk.blue is not a function.
  - tags: node, esm, cjs, chalk, version-drift, common-ai-mistake, software-javascript-module-system
- [Pydantic v2 moved BaseSettings to pydantic-settings](https://koinara.org/records/pydantic-v2-basesettings-moved/)
  - raw Markdown: https://koinara.org/records/pydantic-v2-basesettings-moved.md
  - Agents often use Pydantic v1 examples and write `from pydantic import BaseSettings`. With Pydantic v2 this raises PydanticImportError because BaseSettings moved to the separate `pydantic-settings` package.
  - tags: python, pydantic, pip, version-drift, common-ai-mistake, software-python-packaging