feat(shell): add issue workspace AGENTS context

Author: skulidropek

README.md

@@ -35,6 +35,10 @@ When you clone GitHub issue or PR URLs, docker-git creates isolated project path
 
 This lets you run multiple issues/PRs for the same repository in parallel without container/path collisions.
 
+Agent context for issue workspaces:
+- Global `${CODEX_HOME}/AGENTS.md` includes workspace path + issue/PR context.
+- For `issue-*` workspaces, docker-git creates `${TARGET_DIR}/AGENTS.md` (if missing) with issue context and auto-adds it to `.git/info/exclude`.
+
 ## Projects Root Layout
 
 The projects root is:

packages/docker-git/tests/core/templates.test.ts

@@ -95,4 +95,39 @@ describe("planFiles", () => {
       expect(browserDockerfile !== undefined && browserDockerfile._tag === "File").toBe(true)
       expect(browserScript !== undefined && browserScript._tag === "File").toBe(true)
     }))
+
+  it.effect("embeds issue workspace AGENTS context in entrypoint", () =>
+    Effect.sync(() => {
+      const config: TemplateConfig = {
+        containerName: "dg-repo-issue-5",
+        serviceName: "dg-repo-issue-5",
+        sshUser: "dev",
+        sshPort: 2222,
+        repoUrl: "https://github.com/org/repo.git",
+        repoRef: "issue-5",
+        targetDir: "/home/dev/org/repo/issue-5",
+        volumeName: "dg-repo-issue-5-home",
+        authorizedKeysPath: "./authorized_keys",
+        envGlobalPath: "./.orch/env/global.env",
+        envProjectPath: "./.orch/env/project.env",
+        codexAuthPath: "./.orch/auth/codex",
+        codexSharedAuthPath: "../../.orch/auth/codex",
+        codexHome: "/home/dev/.codex",
+        enableMcpPlaywright: false,
+        pnpmVersion: "10.27.0"
+      }
+
+      const specs = planFiles(config)
+      const entrypointSpec = specs.find(
+        (spec) => spec._tag === "File" && spec.relativePath === "entrypoint.sh"
+      )
+      expect(entrypointSpec !== undefined && entrypointSpec._tag === "File").toBe(true)
+      if (entrypointSpec && entrypointSpec._tag === "File") {
+        expect(entrypointSpec.contents).toContain("Доступные workspace пути:")
+        expect(entrypointSpec.contents).toContain("Контекст workspace:")
+        expect(entrypointSpec.contents).toContain("Issue AGENTS.md:")
+        expect(entrypointSpec.contents).toContain("ISSUE_AGENTS_PATH=\"$TARGET_DIR/AGENTS.md\"")
+        expect(entrypointSpec.contents).toContain("grep -qx \"AGENTS.md\" \"$EXCLUDE_PATH\"")
+      }
+    }))
 })

packages/lib/src/core/templates-entrypoint/codex.ts

@@ -140,11 +140,42 @@ export const renderEntrypointAgentsNotice = (config: TemplateConfig): string =>
 AGENTS_PATH="${config.codexHome}/AGENTS.md"
 LEGACY_AGENTS_PATH="/home/${config.sshUser}/AGENTS.md"
 PROJECT_LINE="Рабочая папка проекта (git clone): ${config.targetDir}"
+WORKSPACES_LINE="Доступные workspace пути: ${config.targetDir}"
+WORKSPACE_INFO_LINE="Контекст workspace: repository"
+FOCUS_LINE="Фокус задачи: работай только в workspace, который запрашивает пользователь. Текущий workspace: ${config.targetDir}"
+ISSUE_AGENTS_HINT_LINE="Issue AGENTS.md: n/a"
 INTERNET_LINE="Доступ к интернету: есть. Если чего-то не знаешь — ищи в интернете или по кодовой базе."
+if [[ "$REPO_REF" == issue-* ]]; then
+  ISSUE_ID="$(printf "%s" "$REPO_REF" | sed -E 's#^issue-##')"
+  ISSUE_URL=""
+  if [[ "$REPO_URL" == https://github.com/* ]]; then
+    ISSUE_REPO="$(printf "%s" "$REPO_URL" | sed -E 's#^https://github.com/##; s#\.git$##; s#/*$##')"
+    if [[ -n "$ISSUE_REPO" ]]; then
+      ISSUE_URL="https://github.com/\${ISSUE_REPO}/issues/\${ISSUE_ID}"
+    fi
+  fi
+  if [[ -n "$ISSUE_URL" ]]; then
+    WORKSPACE_INFO_LINE="Контекст workspace: issue #\${ISSUE_ID} (\${ISSUE_URL})"
+  else
+    WORKSPACE_INFO_LINE="Контекст workspace: issue #\${ISSUE_ID}"
+  fi
+  ISSUE_AGENTS_HINT_LINE="Issue AGENTS.md: ${config.targetDir}/AGENTS.md"
+elif [[ "$REPO_REF" == refs/pull/*/head ]]; then
+  PR_ID="$(printf "%s" "$REPO_REF" | sed -E 's#^refs/pull/([0-9]+)/head$#\1#')"
+  if [[ -n "$PR_ID" ]]; then
+    WORKSPACE_INFO_LINE="Контекст workspace: PR #\${PR_ID}"
+  else
+    WORKSPACE_INFO_LINE="Контекст workspace: pull request (\${REPO_REF})"
+  fi
+fi
 if [[ ! -f "$AGENTS_PATH" ]]; then
   cat <<'AGENTS_EOF' > "$AGENTS_PATH"
 Ты автономный агент, который имеет полностью все права управления контейнером. У тебя есть доступ к командам sudo, gh, codex, git, node, pnpm и всем остальным другим. Проекты с которыми идёт работа лежат по пути ~
 Рабочая папка проекта (git clone): ${config.targetDir}
+Доступные workspace пути: ${config.targetDir}
+Контекст workspace: repository
+Фокус задачи: работай только в workspace, который запрашивает пользователь. Текущий workspace: ${config.targetDir}
+Issue AGENTS.md: n/a
 Доступ к интернету: есть. Если чего-то не знаешь — ищи в интернете или по кодовой базе.
 Если ты видишь файлы AGENTS.md внутри проекта, ты обязан их читать и соблюдать инструкции.
 AGENTS_EOF
@@ -156,6 +187,26 @@ if [[ -f "$AGENTS_PATH" ]]; then
   else
     printf "%s\n" "$PROJECT_LINE" >> "$AGENTS_PATH"
   fi
+  if grep -q "^Доступные workspace пути:" "$AGENTS_PATH"; then
+    sed -i "s|^Доступные workspace пути:.*$|$WORKSPACES_LINE|" "$AGENTS_PATH"
+  else
+    printf "%s\n" "$WORKSPACES_LINE" >> "$AGENTS_PATH"
+  fi
+  if grep -q "^Контекст workspace:" "$AGENTS_PATH"; then
+    sed -i "s|^Контекст workspace:.*$|$WORKSPACE_INFO_LINE|" "$AGENTS_PATH"
+  else
+    printf "%s\n" "$WORKSPACE_INFO_LINE" >> "$AGENTS_PATH"
+  fi
+  if grep -q "^Фокус задачи:" "$AGENTS_PATH"; then
+    sed -i "s|^Фокус задачи:.*$|$FOCUS_LINE|" "$AGENTS_PATH"
+  else
+    printf "%s\n" "$FOCUS_LINE" >> "$AGENTS_PATH"
+  fi
+  if grep -q "^Issue AGENTS.md:" "$AGENTS_PATH"; then
+    sed -i "s|^Issue AGENTS.md:.*$|$ISSUE_AGENTS_HINT_LINE|" "$AGENTS_PATH"
+  else
+    printf "%s\n" "$ISSUE_AGENTS_HINT_LINE" >> "$AGENTS_PATH"
+  fi
   if grep -q "^Доступ к интернету:" "$AGENTS_PATH"; then
     sed -i "s|^Доступ к интернету:.*$|$INTERNET_LINE|" "$AGENTS_PATH"
   else

packages/lib/src/core/templates-entrypoint/tasks.ts

@@ -90,8 +90,50 @@ const renderCloneBodyRef = (config: TemplateConfig): string =>
     fi
   fi`
 
+const renderIssueWorkspaceAgents = (): string =>
+  `if [[ "$CLONE_OK" -eq 1 && "$REPO_REF" == issue-* && -d "$TARGET_DIR/.git" ]]; then
+  ISSUE_ID="$(printf "%s" "$REPO_REF" | sed -E 's#^issue-##')"
+  ISSUE_URL=""
+  if [[ "$REPO_URL" == https://github.com/* ]]; then
+    ISSUE_REPO="$(printf "%s" "$REPO_URL" | sed -E 's#^https://github.com/##; s#\.git$##; s#/*$##')"
+    if [[ -n "$ISSUE_REPO" ]]; then
+      ISSUE_URL="https://github.com/\${ISSUE_REPO}/issues/\${ISSUE_ID}"
+    fi
+  fi
+
+  ISSUE_AGENTS_PATH="$TARGET_DIR/AGENTS.md"
+  if [[ ! -e "$ISSUE_AGENTS_PATH" ]]; then
+    cat <<EOF > "$ISSUE_AGENTS_PATH"
+# docker-git issue workspace
+Issue workspace: #\${ISSUE_ID}
+Issue URL: \${ISSUE_URL:-n/a}
+Workspace path: $TARGET_DIR
+
+Работай только над этим issue, если пользователь не попросил другое.
+Если нужен первоисточник требований, открой Issue URL.
+EOF
+    chown 1000:1000 "$ISSUE_AGENTS_PATH" || true
+  fi
+
+  EXCLUDE_PATH="$TARGET_DIR/.git/info/exclude"
+  if [[ -f "$ISSUE_AGENTS_PATH" ]]; then
+    touch "$EXCLUDE_PATH"
+    if ! grep -qx "AGENTS.md" "$EXCLUDE_PATH"; then
+      printf "%s\n" "AGENTS.md" >> "$EXCLUDE_PATH"
+    fi
+  fi
+fi`
+
 const renderCloneBody = (config: TemplateConfig): string =>
-  [renderCloneBodyStart(config), renderCloneBodyRef(config), "", renderCloneRemotes(config), "fi"].join("\n")
+  [
+    renderCloneBodyStart(config),
+    renderCloneBodyRef(config),
+    "",
+    renderCloneRemotes(config),
+    "",
+    renderIssueWorkspaceAgents(),
+    "fi"
+  ].join("\n")
 
 const renderCloneFinalize = (): string =>
   `if [[ "$CLONE_OK" -eq 1 ]]; then