.gitea/workflows/ci.yml

@@ -9,23 +9,251 @@ jobs:
     runs-on: ubuntu-latest
     env:
       GOPROXY: https://goproxy.cn,direct
+      GOTOOLCHAIN: local
+      GOWORK: "off"
+      GOPRIVATE: git-ssh.u1680832.nyat.app/weichen
     steps:
       - name: Checkout
         env:
           TOKEN: ${{ secrets.GITHUB_TOKEN }}
           SUBMODULE_TOKEN: ${{ secrets.SUBMODULE_TOKEN }}
-        run: |
+        run: &trusted_acquisition_1 |
           set -euo pipefail
-          git init -q
+          python3 - <<'PY_TRUSTED'
-          git remote add origin "${GITHUB_SERVER_URL}/${GITHUB_REPOSITORY}.git"
+          # Trusted workflow code only: never import or execute checkout scripts here.
-          git -c http.extraheader="AUTHORIZATION: token ${TOKEN}" fetch --depth=1 origin "${GITHUB_SHA}"
+          # Token scopes, workflow provenance and runner isolation are platform NOT_RUN.
-          git checkout -q --detach FETCH_HEAD
+          import json
-          if [ -z "${SUBMODULE_TOKEN}" ]; then
+          import os
-            echo "SUBMODULE_TOKEN is not configured" >&2
+          from pathlib import Path
-            exit 1
+          import re
-          fi
+          import shlex
-          git config --global url."https://weichen:${SUBMODULE_TOKEN}@git-home.u1680832.nyat.app:30319/".insteadOf "ssh://git@git-ssh.u1680832.nyat.app:31411/"
+          import subprocess
-          git -c fetch.recurseSubmodules=false submodule update --init --recursive
+          import sys
+          import tempfile
+          from urllib.parse import urlsplit
+
+          SERVER = os.environ.get("GITHUB_SERVER_URL", "").rstrip("/")
+          parsed = urlsplit(SERVER)
+          if (parsed.scheme not in {"http", "https"} or not parsed.netloc or
+                  parsed.username or parsed.password or parsed.query or parsed.fragment):
+              sys.exit("Acquisition requires the platform-injected http(s) server")
+          SSH = "ssh://git@git-ssh.u1680832.nyat.app:31411/weichen/"
+          GO_PREFIX = "git-ssh.u1680832.nyat.app/weichen/"
+          REPOS = {"Agent-System-Dev", "Logging-System", "Error-Code-System", "Agent-System-Core", "Agent-Native",
+                   "Agent-Intent", "Agent-Command", "Agent-Squad", "Agent-System-Backend",
+                   "Agent-System-Frontend", "Agent-System-UI", "Agent-System-RDM",
+                   "Development-Guidelines", "Agent-System-Documents"}
+          LEGACY = {
+              "modules/core": "Agent-System-Core", "modules/backend": "Agent-System-Backend",
+              "modules/frontend": "Agent-System-Frontend", "modules/ui": "Agent-System-UI",
+              "modules/documents": "Agent-System-Documents", "deps/agent-system-core": "Agent-System-Core",
+              "deps/development-guidelines": "Development-Guidelines", "deps/agent-native": "Agent-Native",
+              "deps/agent-squad": "Agent-Squad", "deps/agent-intent": "Agent-Intent",
+              "deps/agent-command": "Agent-Command", "deps/error-code-system": "Error-Code-System",
+              "deps/logging-system": "Logging-System", "pins/agent-system-backend": "Agent-System-Backend",
+              "pins/agent-system-core": "Agent-System-Core", "pins/agent-system-frontend": "Agent-System-Frontend",
+              "pins/agent-system-ui": "Agent-System-UI",
+          }
+          GO_REPOS = REPOS - {"Agent-System-Dev", "Agent-System-UI", "Agent-System-Frontend", "Development-Guidelines", "Agent-System-Documents"}
+          GO_MODULES = {GO_PREFIX + repo + ".git" for repo in GO_REPOS}
+          GO_MODULES |= {GO_PREFIX + "Agent-Squad.git/" + suffix for suffix in
+                         ("adapters/native", "adapters/intent", "adapters/sqlite", "adapters/a2a", "cmd/agent-squad")}
+          root_token = os.environ.pop("TOKEN", "")
+          component_token = os.environ.pop("SUBMODULE_TOKEN", "")
+          # Go environment files and inherited Git tracing/config must not change acquisition.
+          clean = {k: v for k, v in os.environ.items()
+                   if not k.startswith(("GIT_", "NPM_CONFIG_", "npm_config_")) and
+                   not any(word in k.upper() for word in ("TOKEN", "PASSWORD", "SECRET"))}
+          clean.update(GIT_CONFIG_NOSYSTEM="1", GIT_CONFIG_SYSTEM="/dev/null", GIT_CONFIG_GLOBAL="/dev/null",
+                       GIT_TERMINAL_PROMPT="0", GOENV="off", GOTOOLCHAIN="local", GOWORK="off", GOFLAGS="-mod=readonly",
+                       GOPRIVATE=GO_PREFIX.rstrip("/"), GONOPROXY=GO_PREFIX.rstrip("/"), GONOSUMDB=GO_PREFIX.rstrip("/"))
+          if os.environ.get("npm_config_cache"):
+              clean["npm_config_cache"] = os.environ["npm_config_cache"]
+          config = {"core.hooksPath": "/dev/null", "core.fsmonitor": "false", "init.templateDir": "",
+                    "credential.helper": "", "fetch.recurseSubmodules": "false", "submodule.recurse": "false",
+                    "http.followRedirects": "false", "protocol.allow": "never", "protocol." + parsed.scheme + ".allow": "always"}
+          root = Path.cwd()
+          mirrors = root / ".ci-mirrors"
+
+          def process_env(values):
+              env = clean | {"GIT_CONFIG_COUNT": str(len(values))}
+              for index, (key, value) in enumerate(values.items()):
+                  env[f"GIT_CONFIG_KEY_{index}"] = key
+                  env[f"GIT_CONFIG_VALUE_{index}"] = value
+              return env
+
+          def git(directory, *args, token="", repo=""):
+              values = config.copy()
+              if token:
+                  if repo not in REPOS:
+                      raise ValueError("Credential destination is outside the reviewed repository allowlist")
+                  values[f"http.{SERVER}/weichen/{repo}.git.extraheader"] = "AUTHORIZATION: token " + token
+              result = subprocess.run(["git", "-C", str(directory), *args], env=process_env(values),
+                                      check=True, stdout=subprocess.PIPE, stderr=subprocess.PIPE)
+              return result.stdout
+
+          def fixed_sha(value):
+              if not isinstance(value, str) or not re.fullmatch(r"[0-9a-fA-F]{40}", value):
+                  raise ValueError("Source acquisition requires a fixed commit SHA")
+              return value.lower()
+
+          def mirror(repo, sha, token):
+              sha = fixed_sha(sha)
+              destination = mirrors / (repo + ".git")
+              if destination.is_symlink() or mirrors.is_symlink():
+                  raise ValueError("Mirror directory cannot be a symlink")
+              mirrors.mkdir(exist_ok=True)
+              if not destination.exists():
+                  destination.mkdir()
+                  git(destination, "init", "--bare", "-q")
+              url = f"{SERVER}/weichen/{repo}.git"
+              try:
+                  git(destination, "cat-file", "-e", sha + "^{commit}")
+              except subprocess.CalledProcessError:
+                  git(destination, "fetch", "--depth=200", url, sha, token=token, repo=repo)
+              git(destination, "update-ref", "refs/heads/main", sha)
+              git(destination, "symbolic-ref", "HEAD", "refs/heads/main")
+              git(destination, "update-ref", "refs/ci/" + sha, sha)
+              return destination
+
+          def mirror_env():
+              values = {"protocol.file.allow": "always", "core.hooksPath": "/dev/null", "credential.helper": ""}
+              # Distinct keys use repeated .insteadOf values, represented as a sequence below.
+              pairs = list(values.items())
+              for repo in sorted(REPOS):
+                  destination = mirrors / (repo + ".git")
+                  if not destination.exists():
+                      continue
+                  key = "url." + destination.as_uri() + ".insteadOf"
+                  pairs.extend((key, url) for url in (SSH + repo + ".git", "https://" + GO_PREFIX + repo + ".git",
+                                                     SERVER + "/weichen/" + repo + ".git", "https://" + GO_PREFIX + repo))
+              env = clean | {"CI_DEPENDENCY_MIRRORS": str(mirrors), "GIT_CONFIG_COUNT": str(len(pairs))}
+              for index, (key, value) in enumerate(pairs):
+                  env[f"GIT_CONFIG_KEY_{index}"] = key
+                  env[f"GIT_CONFIG_VALUE_{index}"] = value
+              exports = {k: v for k, v in env.items() if k.startswith("GIT_CONFIG_") or k == "CI_DEPENDENCY_MIRRORS"}
+              (root / ".ci-mirrors.env").write_text("".join("export " + k + "=" + shlex.quote(v) + "\n" for k, v in exports.items()))
+              return env
+
+          def materialize_legacy(directory, depth=0):
+              if depth > 16:
+                  raise ValueError("Historical submodule depth exceeds the checkout limit")
+              links = {}
+              for entry in git(directory, "ls-tree", "-rz", "HEAD").split(b"\0"):
+                  if entry:
+                      metadata, path = entry.split(b"\t", 1)
+                      mode, kind, commit = metadata.decode().split()
+                      if mode == "160000":
+                          links[path.decode()] = commit
+              if not links:
+                  return
+              raw = git(directory, "config", "--no-includes", "--blob", "HEAD:.gitmodules", "--null", "--list")
+              entries = {}
+              for item in raw.split(b"\0"):
+                  if not item:
+                      continue
+                  key, value = item.decode().split("\n", 1)
+                  match = re.fullmatch(r"submodule\.(.+)\.(path|url)", key)
+                  if not match:
+                      raise ValueError("Unsupported candidate .gitmodules setting")
+                  name, field = match.groups()
+                  if field in entries.setdefault(name, {}):
+                      raise ValueError("Duplicate candidate .gitmodules setting")
+                  entries[name][field] = value
+              if set(entries) != set(links):
+                  raise ValueError("Submodule names must match fixed gitlink paths")
+              for name, fields in entries.items():
+                  repo = LEGACY.get(name)
+                  if not repo or fields.get("path") != name or fields.get("url") not in {
+                          SSH + repo + ".git", f"{SERVER}/weichen/{repo}.git"}:
+                      raise ValueError("Historical submodule source is outside the reviewed allowlist")
+              for name in entries:
+                  repo = LEGACY[name]
+                  sha = links[name]
+                  url = f"{SERVER}/weichen/{repo}.git"
+                  git(directory, "config", f"submodule.{name}.url", url)
+                  # Trusted explicit checkout prevents candidate update commands from running.
+                  git(directory, "submodule", "update", "--init", "--checkout", "--", name, token=component_token, repo=repo)
+                  child = directory / name
+                  if git(child, "rev-parse", "HEAD").decode().strip() != sha:
+                      raise ValueError("Historical submodule does not match its fixed SHA")
+                  mirror(repo, sha, component_token)
+                  materialize_legacy(child, depth + 1)
+
+          def materialize_manifest(directory):
+              manifest = directory / "components.json"
+              lock = directory / "components.lock.json"
+              if not manifest.exists() and not lock.exists():
+                  materialize_legacy(directory)
+                  return
+              data = json.loads(manifest.read_text())
+              locked = json.loads(lock.read_text())
+              if data.get("schema") != 1 or locked.get("schema") != 1:
+                  raise ValueError("Unsupported source manifest schema")
+              entries = {}
+              for item in data["components"]:
+                  repo = item["id"]
+                  path = ".workspace/" + repo
+                  if (repo not in REPOS or repo in entries or item["path"] != path or
+                          item["repo"] not in {SSH + repo + ".git", f"{SERVER}/weichen/{repo}.git"} or
+                          item.get("role") not in {"go-library", "npm-library", "application", "guidelines", "documentation"}):
+                      raise ValueError("Candidate source manifest is outside the reviewed allowlist")
+                  for module in item.get("modules", []):
+                      if module.get("path") not in GO_MODULES or not module["path"].startswith(GO_PREFIX + repo + ".git"):
+                          raise ValueError("Candidate module mapping is outside the reviewed allowlist")
+                  entries[repo] = item
+              selected = locked["components"]
+              if set(selected) - set(entries):
+                  raise ValueError("Source lock refers to an unregistered repository")
+              for repo, item in entries.items():
+                  if item["role"] in {"application", "guidelines", "documentation"} and repo not in selected:
+                      raise ValueError("Application and documentation source needs a fixed lock")
+              for repo, pin in selected.items():
+                  fixed_sha(pin["commit"])
+                  destination = directory / entries[repo]["path"]
+                  if destination.exists() or destination.is_symlink() or destination.parent.is_symlink():
+                      raise ValueError("Source materialization requires a fresh destination")
+              # Validate the complete lock before any authenticated component fetch.
+              for repo, pin in selected.items():
+                  sha = fixed_sha(pin["commit"])
+                  destination = directory / entries[repo]["path"]
+                  destination.mkdir(parents=True)
+                  url = f"{SERVER}/weichen/{repo}.git"
+                  git(destination, "init", "-q")
+                  git(destination, "remote", "add", "origin", url)
+                  git(destination, "fetch", "--depth=1", "origin", sha, token=component_token, repo=repo)
+                  git(destination, "checkout", "-q", "--detach", "FETCH_HEAD")
+                  if git(destination, "rev-parse", "HEAD").decode().strip() != sha:
+                      raise ValueError("Materialized source differs from the fixed lock")
+                  # Persist the registered identity; process config chooses the transport.
+                  git(destination, "remote", "set-url", "origin", entries[repo]["repo"])
+                  mirror(repo, sha, component_token)
+                  materialize_legacy(destination)
+
+          try:
+              if os.environ.get("GITHUB_REPOSITORY") != "weichen/Agent-Intent":
+                  raise ValueError("Checkout repository is outside the reviewed allowlist")
+              sha = fixed_sha(os.environ.get("GITHUB_SHA", ""))
+              if not root_token:
+                  raise ValueError("Checkout requires TOKEN")
+              if (root / ".git").exists():
+                  raise ValueError("Checkout requires a fresh workspace")
+              git(root, "init", "-q")
+              git(root, "remote", "add", "origin", SERVER + "/weichen/Agent-Intent.git")
+              git(root, "fetch", "--depth=1", "origin", sha, token=root_token, repo="Agent-Intent")
+              git(root, "checkout", "-q", "--detach", "FETCH_HEAD")
+              if git(root, "rev-parse", "HEAD").decode().strip() != sha:
+                  raise ValueError("Checked-out commit differs from the platform commit")
+              if (root / ".ci-mirrors").exists() or (root / ".ci-mirrors.env").exists():
+                  raise ValueError("Candidate cannot provide trusted prefetch state")
+              materialize_manifest(root)
+              mirror_env()
+          except (ValueError, KeyError, OSError, subprocess.CalledProcessError) as error:
+              # Do not print child stderr or environment: a failed credential fetch stays redacted.
+              sys.exit("Checkout refused: " + str(error))
+          print("Fixed source checkout complete; credentials were not persisted")
+          PY_TRUSTED
+          unset TOKEN SUBMODULE_TOKEN
       - name: Install Go 1.27.1
         run: |
           set -euo pipefail
@@ -33,21 +261,250 @@ jobs:
           tar -C /usr/local -xzf "$RUNNER_TEMP/go.tgz"
           ln -sfn /usr/local/go/bin/go /usr/local/bin/go
           ln -sfn /usr/local/go/bin/gofmt /usr/local/bin/gofmt
+      - name: Prefetch Go modules without executing candidate code
+        env:
+          SUBMODULE_TOKEN: ${{ secrets.SUBMODULE_TOKEN }}
+        run: &trusted_acquisition_2 |
+          set -euo pipefail
+          python3 - <<'PY_TRUSTED'
+          # Trusted workflow code only: never import or execute checkout scripts here.
+          # Token scopes, workflow provenance and runner isolation are platform NOT_RUN.
+          import json
+          import os
+          from pathlib import Path
+          import re
+          import shlex
+          import subprocess
+          import sys
+          import tempfile
+          from urllib.parse import urlsplit
+
+          SERVER = os.environ.get("GITHUB_SERVER_URL", "").rstrip("/")
+          parsed = urlsplit(SERVER)
+          if (parsed.scheme not in {"http", "https"} or not parsed.netloc or
+                  parsed.username or parsed.password or parsed.query or parsed.fragment):
+              sys.exit("Acquisition requires the platform-injected http(s) server")
+          SSH = "ssh://git@git-ssh.u1680832.nyat.app:31411/weichen/"
+          GO_PREFIX = "git-ssh.u1680832.nyat.app/weichen/"
+          REPOS = {"Agent-System-Dev", "Logging-System", "Error-Code-System", "Agent-System-Core", "Agent-Native",
+                   "Agent-Intent", "Agent-Command", "Agent-Squad", "Agent-System-Backend",
+                   "Agent-System-Frontend", "Agent-System-UI", "Agent-System-RDM",
+                   "Development-Guidelines", "Agent-System-Documents"}
+          LEGACY = {
+              "modules/core": "Agent-System-Core", "modules/backend": "Agent-System-Backend",
+              "modules/frontend": "Agent-System-Frontend", "modules/ui": "Agent-System-UI",
+              "modules/documents": "Agent-System-Documents", "deps/agent-system-core": "Agent-System-Core",
+              "deps/development-guidelines": "Development-Guidelines", "deps/agent-native": "Agent-Native",
+              "deps/agent-squad": "Agent-Squad", "deps/agent-intent": "Agent-Intent",
+              "deps/agent-command": "Agent-Command", "deps/error-code-system": "Error-Code-System",
+              "deps/logging-system": "Logging-System", "pins/agent-system-backend": "Agent-System-Backend",
+              "pins/agent-system-core": "Agent-System-Core", "pins/agent-system-frontend": "Agent-System-Frontend",
+              "pins/agent-system-ui": "Agent-System-UI",
+          }
+          GO_REPOS = REPOS - {"Agent-System-Dev", "Agent-System-UI", "Agent-System-Frontend", "Development-Guidelines", "Agent-System-Documents"}
+          GO_MODULES = {GO_PREFIX + repo + ".git" for repo in GO_REPOS}
+          GO_MODULES |= {GO_PREFIX + "Agent-Squad.git/" + suffix for suffix in
+                         ("adapters/native", "adapters/intent", "adapters/sqlite", "adapters/a2a", "cmd/agent-squad")}
+          root_token = os.environ.pop("TOKEN", "")
+          component_token = os.environ.pop("SUBMODULE_TOKEN", "")
+          # Go environment files and inherited Git tracing/config must not change acquisition.
+          clean = {k: v for k, v in os.environ.items()
+                   if not k.startswith(("GIT_", "NPM_CONFIG_", "npm_config_")) and
+                   not any(word in k.upper() for word in ("TOKEN", "PASSWORD", "SECRET"))}
+          clean.update(GIT_CONFIG_NOSYSTEM="1", GIT_CONFIG_SYSTEM="/dev/null", GIT_CONFIG_GLOBAL="/dev/null",
+                       GIT_TERMINAL_PROMPT="0", GOENV="off", GOTOOLCHAIN="local", GOWORK="off", GOFLAGS="-mod=readonly",
+                       GOPRIVATE=GO_PREFIX.rstrip("/"), GONOPROXY=GO_PREFIX.rstrip("/"), GONOSUMDB=GO_PREFIX.rstrip("/"))
+          if os.environ.get("npm_config_cache"):
+              clean["npm_config_cache"] = os.environ["npm_config_cache"]
+          config = {"core.hooksPath": "/dev/null", "core.fsmonitor": "false", "init.templateDir": "",
+                    "credential.helper": "", "fetch.recurseSubmodules": "false", "submodule.recurse": "false",
+                    "http.followRedirects": "false", "protocol.allow": "never", "protocol." + parsed.scheme + ".allow": "always"}
+          root = Path.cwd()
+          mirrors = root / ".ci-mirrors"
+
+          def process_env(values):
+              env = clean | {"GIT_CONFIG_COUNT": str(len(values))}
+              for index, (key, value) in enumerate(values.items()):
+                  env[f"GIT_CONFIG_KEY_{index}"] = key
+                  env[f"GIT_CONFIG_VALUE_{index}"] = value
+              return env
+
+          def git(directory, *args, token="", repo=""):
+              values = config.copy()
+              if token:
+                  if repo not in REPOS:
+                      raise ValueError("Credential destination is outside the reviewed repository allowlist")
+                  values[f"http.{SERVER}/weichen/{repo}.git.extraheader"] = "AUTHORIZATION: token " + token
+              result = subprocess.run(["git", "-C", str(directory), *args], env=process_env(values),
+                                      check=True, stdout=subprocess.PIPE, stderr=subprocess.PIPE)
+              return result.stdout
+
+          def fixed_sha(value):
+              if not isinstance(value, str) or not re.fullmatch(r"[0-9a-fA-F]{40}", value):
+                  raise ValueError("Source acquisition requires a fixed commit SHA")
+              return value.lower()
+
+          def mirror(repo, sha, token):
+              sha = fixed_sha(sha)
+              destination = mirrors / (repo + ".git")
+              if destination.is_symlink() or mirrors.is_symlink():
+                  raise ValueError("Mirror directory cannot be a symlink")
+              mirrors.mkdir(exist_ok=True)
+              if not destination.exists():
+                  destination.mkdir()
+                  git(destination, "init", "--bare", "-q")
+              url = f"{SERVER}/weichen/{repo}.git"
+              try:
+                  git(destination, "cat-file", "-e", sha + "^{commit}")
+              except subprocess.CalledProcessError:
+                  git(destination, "fetch", "--depth=200", url, sha, token=token, repo=repo)
+              git(destination, "update-ref", "refs/heads/main", sha)
+              git(destination, "symbolic-ref", "HEAD", "refs/heads/main")
+              git(destination, "update-ref", "refs/ci/" + sha, sha)
+              return destination
+
+          def mirror_env():
+              values = {"protocol.file.allow": "always", "core.hooksPath": "/dev/null", "credential.helper": ""}
+              # Distinct keys use repeated .insteadOf values, represented as a sequence below.
+              pairs = list(values.items())
+              for repo in sorted(REPOS):
+                  destination = mirrors / (repo + ".git")
+                  if not destination.exists():
+                      continue
+                  key = "url." + destination.as_uri() + ".insteadOf"
+                  pairs.extend((key, url) for url in (SSH + repo + ".git", "https://" + GO_PREFIX + repo + ".git",
+                                                     SERVER + "/weichen/" + repo + ".git", "https://" + GO_PREFIX + repo))
+              env = clean | {"CI_DEPENDENCY_MIRRORS": str(mirrors), "GIT_CONFIG_COUNT": str(len(pairs))}
+              for index, (key, value) in enumerate(pairs):
+                  env[f"GIT_CONFIG_KEY_{index}"] = key
+                  env[f"GIT_CONFIG_VALUE_{index}"] = value
+              exports = {k: v for k, v in env.items() if k.startswith("GIT_CONFIG_") or k == "CI_DEPENDENCY_MIRRORS"}
+              (root / ".ci-mirrors.env").write_text("".join("export " + k + "=" + shlex.quote(v) + "\n" for k, v in exports.items()))
+              return env
+
+          def source_roots():
+              bases = [root]
+              composition = root / ".ci-composition-dev"
+              if composition.is_dir() and not composition.is_symlink():
+                  bases.append(composition)
+              paths = []
+              for base in bases:
+                  paths += [base, base / "rdm"] + [base / path for path in LEGACY] + [base / ".workspace" / repo for repo in sorted(REPOS)]
+              return [path for path in paths if path.is_dir() and not path.is_symlink()]
+          try:
+              targets = []
+              for source in source_roots():
+                  for suffix in (".", "examples/trace", "adapters/native", "adapters/intent", "adapters/sqlite", "adapters/a2a", "cmd/agent-squad"):
+                      directory = source / suffix
+                      if (directory / "go.mod").is_file() and directory.resolve() not in targets:
+                          targets.append(directory.resolve())
+              # Parse using the installed local Go tool without credentials or candidate execution.
+              original_files = {}
+              for directory in targets:
+                  parsed_mod = json.loads(subprocess.check_output(["go", "mod", "edit", "-json"], cwd=directory, env=clean))
+                  canonical = parsed_mod["Module"]["Path"].startswith(GO_PREFIX)
+                  for name in ("go.mod", "go.sum"):
+                      dependency_file = directory / name
+                      if dependency_file.is_file():
+                          original_files[(directory, name)] = dependency_file.read_bytes()
+                      elif canonical and name == "go.sum":
+                          original_files[(directory, name)] = None
+                  for dep in (parsed_mod.get("Require") or []):
+                      path = dep["Path"]
+                      if path.startswith(GO_PREFIX) and path not in GO_MODULES:
+                          raise ValueError("Go dependency is outside the reviewed module mapping")
+                  for replacement in (parsed_mod.get("Replace") or []):
+                      path = replacement["New"]["Path"]
+                      if canonical and not replacement["New"].get("Version"):
+                          raise ValueError("Canonical module cannot acquire a local path replacement")
+                      if path.startswith(GO_PREFIX) and path not in GO_MODULES:
+                          raise ValueError("Go replacement is outside the reviewed module mapping")
+              auth = config.copy()
+              for repo in sorted(GO_REPOS):
+                  url = f"{SERVER}/weichen/{repo}.git"
+                  auth[f"url.{url}.insteadOf"] = "https://" + GO_PREFIX + repo
+                  auth[f"http.{url}.extraheader"] = "AUTHORIZATION: token " + component_token
+              def objects(output):
+                  decoder = json.JSONDecoder()
+                  remaining = output.strip()
+                  while remaining:
+                      item, end = decoder.raw_decode(remaining)
+                      remaining = remaining[end:].lstrip()
+                      yield item
+              def unchanged():
+                  for (owner, name), contents in original_files.items():
+                      dependency_file = owner / name
+                      current = dependency_file.read_bytes() if dependency_file.exists() else None
+                      if current != contents:
+                          raise ValueError("Go acquisition modified a committed Go dependency file: " + str(dependency_file))
+              for directory in targets:
+                  # Resolve private go.mod metadata only through exact repository headers;
+                  # validate the complete selected graph before acquiring module zip files.
+                  graph = subprocess.run(["go", "list", "-mod=readonly", "-m", "-json", "all"], cwd=directory,
+                                         env=process_env(auth), capture_output=True, text=True)
+                  if graph.returncode:
+                      raise ValueError("Go selected graph resolution failed: " + graph.stderr.strip())
+                  for item in objects(graph.stdout):
+                      if item.get("Main"):
+                          continue
+                      selected = item.get("Replace") or item
+                      for path in (item.get("Path", ""), selected.get("Path", "")):
+                          if path.startswith(GO_PREFIX) and path not in GO_MODULES:
+                              raise ValueError("Selected Go module is outside the reviewed mapping")
+                  unchanged()
+                  # Go 1.27 can prune go.sum even under -mod=readonly for this
+                  # metadata-only command. Use a disposable copy, then validate actual
+                  # package loading against the unchanged committed source locks.
+                  local_replacements = json.loads(subprocess.check_output(
+                      ["go", "mod", "edit", "-json"], cwd=directory, env=clean)).get("Replace") or []
+                  downloaded = ""
+                  if not any(not item["New"].get("Version") for item in local_replacements):
+                      with tempfile.TemporaryDirectory(prefix="ci-go-prefetch-") as temporary:
+                          download_root = Path(temporary)
+                          for name in ("go.mod", "go.sum"):
+                              if (directory / name).is_file():
+                                  (download_root / name).write_bytes((directory / name).read_bytes())
+                          result = subprocess.run(["go", "mod", "download", "-json"], cwd=download_root,
+                                                  env=process_env(auth), capture_output=True, text=True)
+                          if result.returncode:
+                              raise ValueError("Go module acquisition failed: " + result.stderr.strip())
+                          downloaded = result.stdout
+                  unchanged()
+                  for item in objects(downloaded):
+                      path = item.get("Path", "")
+                      if path.startswith(GO_PREFIX):
+                          if path not in GO_MODULES:
+                              raise ValueError("Resolved Go module is outside the reviewed mapping")
+                          repo = path[len(GO_PREFIX):].split(".git", 1)[0]
+                          origin = item.get("Origin") or json.loads(Path(item["Info"]).read_text()).get("Origin") or {}
+                          mirror(repo, fixed_sha(origin.get("Hash")), component_token)
+                  # Package metadata loads actual test/build dependencies without running
+                  # vet, compilers, package init functions or candidate tests. No CGO tools.
+                  packages = subprocess.run(["go", "list", "-mod=readonly", "-deps", "-test", "./..."], cwd=directory,
+                                            env=process_env(auth) | {"CGO_ENABLED": "0"}, capture_output=True, text=True)
+                  if packages.returncode:
+                      raise ValueError("Go test/build dependency acquisition failed: " + packages.stderr.strip())
+                  unchanged()
+              mirror_env()
+          except (ValueError, OSError, subprocess.CalledProcessError) as error:
+              sys.exit("Go prefetch refused: " + str(error))
+          print("Go modules cached with GOTOOLCHAIN=local; no candidate code executed")
+          PY_TRUSTED
+          unset TOKEN SUBMODULE_TOKEN
       - name: Vet, test, and race
-        run: GOWORK=off go vet ./... && GOWORK=off go test -count=1 ./... && GOWORK=off go test -count=1 -race ./...
+        run: |
+          set -euo pipefail
+          source .ci-mirrors.env
+          GOWORK=off go vet -mod=readonly ./... && GOWORK=off go test -mod=readonly -count=1 ./... && GOWORK=off go test -mod=readonly -count=1 -race ./...
   docker-checkout-hostgateway:
     runs-on: ubuntu-latest
     options: --add-host gitea:host-gateway
     env:
       GITHUB_SERVER_URL: http://gitea:3000
     steps:
-      - name: Checkout without GitHub actions
+      - name: Checkout
         env:
           TOKEN: ${{ secrets.GITHUB_TOKEN }}
-        run: |
+          SUBMODULE_TOKEN: ${{ secrets.SUBMODULE_TOKEN }}
-          set -euo pipefail
+        run: *trusted_acquisition_1
-          git init -q
+      - run: test -f go.mod && echo "docker-mode checkout via host-gateway OK"
-          git remote add origin "${GITHUB_SERVER_URL}/${GITHUB_REPOSITORY}.git"
-          git -c http.extraheader="AUTHORIZATION: token ${TOKEN}" fetch --depth=1 origin "${GITHUB_SHA}"
-          git checkout -q --detach FETCH_HEAD
-          test -f go.mod && echo "docker-mode checkout via host-gateway OK"

.gitmodules

@@ -1,9 +0,0 @@
-[submodule "deps/development-guidelines"]
-	path = deps/development-guidelines
-	url = ssh://git@git-ssh.u1680832.nyat.app:31411/weichen/Development-Guidelines.git
-[submodule "deps/error-code-system"]
-	path = deps/error-code-system
-	url = ssh://git@git-ssh.u1680832.nyat.app:31411/weichen/Error-Code-System.git
-[submodule "deps/logging-system"]
-	path = deps/logging-system
-	url = ssh://git@git-ssh.u1680832.nyat.app:31411/weichen/Logging-System.git

AGENTS.md

@@ -1,6 +1,6 @@
 # Agent 工作说明（Agent-Intent）
 
-本仓开发遵循 Development-Guidelines（Dev 仓 `deps/development-guidelines`，gitlink 固定版本）：
+本仓开发遵循 Development-Guidelines（由 Dev 固定规范来源；新布局见 Dev components.lock.json，规则目录 .workspace/Development-Guidelines；历史布局仍读原 gitlink）：
 核心规则见其 `core/`，按任务触发阅读 `standards/` 专题；日常交付走 `workflows/delivery.md`。
 
 ## 任务启动门禁
@@ -15,7 +15,7 @@
 ## 仓内规则
 
 - 模块边界、公开契约与隔离档位见 `policy/modules/`（如有）与 PROJECT.md。
-- 跨仓 gitlink 变更须经组合验证后在 Dev 仓推进；受保护分支经 PR 合入。
+- 跨仓语言依赖/应用源码锁变更须经固定组合验证后在消费方推进；源码提交到所属仓；受保护分支经 PR 合入。
 - 验证命令见 PROJECT.md「验证」节；完成声明须附实际命令输出证据。
 
 ## Gitea 与 Git 访问事实（2026-09-30 实测）

PROJECT.md

@@ -5,10 +5,10 @@
 ## 仓库与操作
 
 - 目标/产品边界：通用意图识别基础库。提供意图定义（spec）、注册表与配置合并（registry/loader）、四级漏斗识别器（guard → expectation → rules → adjudicate）、槽位抽取与诊断（conformance/catalogcheck/intentctl）。不做动作执行、不内置 LLM 客户端、不含任何业务意图内容，不依赖 Agent-Native / Agent-Squad / Agent-System。
-- 源码、资产、文档、机器契约位置：Go 源码在仓库根包目录；模块路径 `agent-intent`；人类文档在根 `README.md`、`docs/`、`policy/`；过程记录在 `docs/records/`；机器契约以 `intent` 包公开类型为准。
+- 源码、资产、文档、机器契约位置：Go 源码在仓库根包目录；模块路径 `git-ssh.u1680832.nyat.app/weichen/Agent-Intent.git`；人类文档在根 `README.md`、`docs/`、`policy/`；过程记录在 `docs/records/`；机器契约以 `intent` 包公开类型为准。
 - 权威远端、集成基线、受保护分支：`ssh://git@git-ssh.u1680832.nyat.app:31411/weichen/Agent-Intent.git`，集成基线 `main`。
 - 并行共同基线记录位置、合入通知/主动检查方式：任务主记录在 Gitea Issue/PR；合入前在本仓 `main` 上 `git fetch` 并确认 HEAD。
-- 发布线与批准版本/实际制品查询入口：当前无独立制品仓库。可构建性以本仓 `main` 的 `go test` 为准；依赖子模块版本以 gitlink 为准，不把工作区未提交文件当发布组合。
+- 发布线与批准版本/实际制品查询入口：当前无独立制品仓库。可构建性以本仓 `main` 的 `go test` 为准；Go 依赖以 `go.mod` / `go.sum` 为准，不把工作区未提交文件当发布组合。
 - 提交/审核/合并/发布身份与权限：仓库所有者 weichen。本机提交不代替远端合并。
 - 任务唯一来源：Gitea `weichen/Agent-Intent` 的 Issue 与 Pull Request。
 - 规范性文档目录：`policy/`。
@@ -20,20 +20,19 @@
 
 | 逻辑 ID | 路径 | 角色 |
 |---|---|---|
-| development-guidelines | `deps/development-guidelines` | development-only，规范文本 |
+| development-guidelines | Dev `.workspace/Development-Guidelines`（源码锁固定） | development-only，规范文本 |
-| error-code-system | `deps/error-code-system` | build-required，规范码目录（catalogcheck 对齐 + `intent.*` 常量值） |
+| error-code-system | `go.mod` / `go.sum` | build-required，规范码目录（catalogcheck 对齐 + `intent.*` 常量值） |
-| logging-system | `deps/logging-system` | build-required，可选日志器 |
+| logging-system | `go.mod` / `go.sum` | build-required，可选日志器 |
 
 克隆：
 
 ```bash
-git clone --recurse-submodules ssh://git@git-ssh.u1680832.nyat.app:31411/weichen/Agent-Intent.git
+git clone ssh://git@git-ssh.u1680832.nyat.app:31411/weichen/Agent-Intent.git
-# 已克隆时：git submodule update --init --recursive
 ```
 
-构建、审核和发布固定父仓 gitlink，不执行 `submodule update --remote`。
+Go 构建、审核固定 `go.mod` / `go.sum` 版本，正式消费使用 `GOWORK=off`。旧提交保留其 gitlinks 供历史组合和在途分支重建；本提交已移除已替代指针；开发规范由 Dev components.lock.json 固定。
 
-消费方（Agent-Squad / Agent-Native）接入本仓时须自带全部 replace：依赖模块内部的 replace 在上层构建中不生效。
+消费方接入完整模块路径的批准提交，由 `go get MODULE@COMMIT` 生成版本；本地联调由 Dev 显式链接组件，不写入正式 `go.mod`。
 
 ## 验证命令
 
@@ -42,14 +41,14 @@ git clone --recurse-submodules ssh://git@git-ssh.u1680832.nyat.app:31411/weichen
 | 文档 | 人工核对 `AGENTS.md`、`PROJECT.md`、`policy/` 相对链接 | 不证明运行时行为 |
 | 模块/接口 | 仓库根：`GOWORK=off go vet ./... && GOWORK=off go test -count=1 ./...` | 需要 Go 1.27 |
 | 并发/快照隔离 | 仓库根：`GOWORK=off go test -count=1 -race ./...` | 覆盖 Reload 与识别并发 |
-| 依赖纪律 | 仓库根：`GOWORK=off go list -m all` 仅标准库 + 两个生态模块 | 不证明宿主接入正确性 |
+| 依赖纪律 | 仓库根：`GOWORK=off go list -m all` 核对生态模块及 `golang.org/x/text` 的实际版本 | 不证明宿主接入正确性 |
 | 宿主行为验收 | 消费方仓内跑 `conformance.Run` | 本命令不覆盖真实宿主配置 |
 
 ## 环境与数据
 
 | 环境/实例 ID | 只读查询入口 | 授权写入入口 | DB/存储归属 | 恢复入口 |
 |---|---|---|---|---|
-| 本地开发 | 本机工作区与 `go test` | 本机 git 提交 | 无数据库；配置由宿主注入 | 重新 clone 父仓并 `submodule update --init --recursive` |
+| 本地开发 | 本机工作区与 `go test` | 本机 git 提交 | 无数据库；配置由宿主注入 | 普通 clone 并下载 go.mod 固定依赖 |
 
 共享项及 ACL：无。部署、迁移、发布的审批依据与负责角色：当前库不独立部署；合并进 `main` 由仓库所有者批准。
 实际制品/配置/schema 的查询方法：阅读当前 `main` 的 `intent` 包与 `go.mod`，不以历史 README 快照代替。

README.md

@@ -2,7 +2,7 @@
 
 可定义、可配置、可扩展的通用意图识别基础库：把「输入文本 → 意图 + 槽位 + 分支裁决」做成纯内存、确定性的库能力，供宿主在 LLM 之前完成确定性分流——守卫拦截（安全红线、识别即拒绝）、系统功能命令识别、路由提示与多轮澄清入口。
 
-本仓库是该模块的源码位置。Go 模块路径为 `agent-intent`。不依赖 Agent-Native、Agent-Squad 或任何第三方模块；错误码与日志和 Error-Code-System / Logging-System 轻接入对齐（常量对齐 + 鸭子接口，核心包不依赖错误码库）。
+本仓库是该模块的源码位置。Go 模块路径为 `git-ssh.u1680832.nyat.app/weichen/Agent-Intent.git`。不依赖 Agent-Native 或 Agent-Squad；文本处理依赖 `golang.org/x/text`，错误码与日志和 Error-Code-System / Logging-System 轻接入对齐（常量对齐 + 鸭子接口，核心包不依赖错误码库）。
 
 设计目标与边界：
 
@@ -128,27 +128,25 @@ go run ./cmd/intentctl catalog -root configs/intents    # 能力目录（注入
 
 错误常量与 Error-Code-System 对齐（`intent.invalid_spec` / `intent.spec_protected` / `intent.load_failed`，调用方错误复用 `sys.invalid_argument`），`catalogcheck` 测试防双权威；映射表见 [Error-Code-System 的 agent-intent 映射](deps/error-code-system/docs/agent-intent-mapping.md)。错误类型实现 `ErrorCode()` / `ErrorFields()`，logsys 自动展开码与字段。日志为可选注入（`Options.Log`，nil→Nop），事件：`intent recognized`（branch/top/confidence/revision/duration）、`intent snapshot reloaded`、`intent config rejected`；原始输入不写入日志。
 
-## 作为 submodule 使用
+## 版本依赖与消费
 
-消费方把本库固定为 submodule，推荐路径 `deps/agent-intent`；版本以消费方 gitlink 为准，不执行 `submodule update --remote`：
+消费方在已配置私有传输的环境中获取批准提交，由 Go 写入实际版本：
 
 ```bash
-git submodule add ssh://git@git-ssh.u1680832.nyat.app:31411/weichen/Agent-Intent.git deps/agent-intent
+go get git-ssh.u1680832.nyat.app/weichen/Agent-Intent.git@<approved-commit>
+GOWORK=off go test ./...
 ```
 
-```text
+`go.mod` / `go.sum` 固定错误码与日志依赖，无源码目录 `replace`。正式构建使用 `GOWORK=off`；本地源码联调通过 Dev 的显式组件链接管理。接入后建议在消费方测试里用 `conformance.Run` 跑自己的用例集。
-require agent-intent v0.0.0
-replace agent-intent => ./deps/agent-intent
-```
 
-依赖模块内部的 replace 在上层构建中不生效：消费方须自带 `error-code-system` 与 `logging-system` 的 require + replace，并保持与本仓 gitlink 相同的组合。接入后建议在消费方测试里用 `conformance.Run` 跑自己的用例集。
+旧提交保留其 gitlinks 供历史组合和在途分支重建；本提交已移除已替代指针；本版本 Go 编译不消费这些目录，开发规范由 Dev components.lock.json 固定。在途分支显式迁移 import 与模块前缀，不改意图、命令或历史事件标识。
 
 ## 验证
 
 ```bash
 GOWORK=off go vet ./... && GOWORK=off go test -count=1 ./...
 GOWORK=off go test -count=1 -race ./...
-GOWORK=off go list -m all   # 仅标准库 + 两个生态模块
+GOWORK=off go list -m all   # 核对固定版本与 MVS 解析结果
 ```
 
 需要 Go 1.27。规则入口见 [AGENTS.md](AGENTS.md)，项目事实见 [PROJECT.md](PROJECT.md)，设计与验证记录见 `docs/records/`。

catalogcheck/align_test.go

@@ -5,10 +5,10 @@ package catalogcheck
 import (
 	"testing"
 
-	_ "error-code-system/domains" // 填充 errcode.Default 种子码
+	_ "git-ssh.u1680832.nyat.app/weichen/Error-Code-System.git/domains" // 填充 errcode.Default 种子码
-	"error-code-system/errcode"
+	"git-ssh.u1680832.nyat.app/weichen/Error-Code-System.git/errcode"
 
-	"agent-intent/intent"
+	"git-ssh.u1680832.nyat.app/weichen/Agent-Intent.git/intent"
 )
 
 func TestIntentCodesAlignWithCatalog(t *testing.T) {

cmd/intentctl/main.go

@@ -11,7 +11,7 @@ import (
 	"sort"
 	"strings"
 
-	"agent-intent/intent"
+	"git-ssh.u1680832.nyat.app/weichen/Agent-Intent.git/intent"
 )
 
 func main() {

conformance/conformance.go

@@ -9,7 +9,7 @@ import (
 	"sync"
 	"testing"
 
-	"agent-intent/intent"
+	"git-ssh.u1680832.nyat.app/weichen/Agent-Intent.git/intent"
 )
 
 // Case 单条行为验收用例。ExpectTopID 为空断言 Top 为 nil；

conformance/conformance_test.go

@@ -5,7 +5,7 @@ import (
 	"testing"
 	"testing/fstest"
 
-	"agent-intent/intent"
+	"git-ssh.u1680832.nyat.app/weichen/Agent-Intent.git/intent"
 )
 
 func TestRunAcceptsCompliantRecognizer(t *testing.T) {

examples/example_test.go

@@ -7,8 +7,8 @@ import (
 	"embed"
 	"testing"
 
-	"agent-intent/conformance"
+	"git-ssh.u1680832.nyat.app/weichen/Agent-Intent.git/conformance"
-	"agent-intent/intent"
+	"git-ssh.u1680832.nyat.app/weichen/Agent-Intent.git/intent"
 )
 
 //go:embed specs/*.json

go.mod

@@ -1,14 +1,9 @@
-module agent-intent
+module git-ssh.u1680832.nyat.app/weichen/Agent-Intent.git
 
 go 1.27
 
 require (
-	error-code-system v0.0.0
+	git-ssh.u1680832.nyat.app/weichen/Error-Code-System.git v0.0.0-20261013150648-28d2d5074347
-	logging-system v0.0.0
+	git-ssh.u1680832.nyat.app/weichen/Logging-System.git v0.0.0-20261013150647-9c5442f06d05
+	golang.org/x/text v0.29.0
 )
-
-require golang.org/x/text v0.29.0 // indirect
-
-replace error-code-system => ./deps/error-code-system
-
-replace logging-system => ./deps/logging-system

go.sum

@@ -1,2 +1,6 @@
+git-ssh.u1680832.nyat.app/weichen/Error-Code-System.git v0.0.0-20261013150648-28d2d5074347 h1:mESnwe9ZpZqpLoGPzLyCWEmXDHKm7ouKC8qpF8EztEQ=
+git-ssh.u1680832.nyat.app/weichen/Error-Code-System.git v0.0.0-20261013150648-28d2d5074347/go.mod h1:b8CDy31Xo3uRzAhA3HldwcgNnk0x5Lb02osIb9ewJ3A=
+git-ssh.u1680832.nyat.app/weichen/Logging-System.git v0.0.0-20261013150647-9c5442f06d05 h1:gtFuWlGr7GlpEkuoIfIw6f/uXHUlYXlHU2qgLWAV46Y=
+git-ssh.u1680832.nyat.app/weichen/Logging-System.git v0.0.0-20261013150647-9c5442f06d05/go.mod h1:Jg/bDRsd1/g5YjIoEUYkCsTgJOrTolYccfyb/tc57Dk=
 golang.org/x/text v0.29.0 h1:1neNs90w9YzJ9BocxfsQNHKuAT4pkghyXc4nhZ6sJvk=
 golang.org/x/text v0.29.0/go.mod h1:7MhJOA9CD2qZyOKYazxdYMF85OwPdEr9jTtBpO7ydH4=

intent/recognizer.go

@@ -8,7 +8,7 @@ import (
 	"strings"
 	"time"
 
-	"logging-system/logsys"
+	"git-ssh.u1680832.nyat.app/weichen/Logging-System.git/logsys"
 )
 
 // Recognizer 是识别的公开端口（Query 语义：纯函数式、无副作用）。

intent/registry.go

@@ -11,7 +11,7 @@ import (
 	"sync"
 	"sync/atomic"
 
-	"logging-system/logsys"
+	"git-ssh.u1680832.nyat.app/weichen/Logging-System.git/logsys"
 )
 
 // Options 注册表与识别器的共享选项。零值字段在构建时填入默认值；

schema/roundtrip_test.go

@@ -5,7 +5,7 @@ import (
 	"os"
 	"testing"
 
-	"agent-intent/intent"
+	"git-ssh.u1680832.nyat.app/weichen/Agent-Intent.git/intent"
 )
 
 func TestIntentSpecRoundTrip(t *testing.T) {