🔧 chore(tsl): add playbook sync workflow
This commit is contained in:
@@ -0,0 +1,66 @@
|
||||
#!/usr/bin/env bash
|
||||
set -euo pipefail
|
||||
|
||||
# Build the minimal TSL playbook bundle and publish its *expanded* contents to
|
||||
# the tsl-playbook branch. The branch tree mirrors the bundle root directly
|
||||
# (AGENTS.md, docs/, skills/) — there is no wrapping tsl-playbook/ directory.
|
||||
|
||||
REPO_DIR="${REPO_DIR:-$(pwd)}"
|
||||
TARGET_BRANCH="${TARGET_BRANCH:-tsl-playbook}"
|
||||
BUILD_SCRIPT="${BUILD_SCRIPT:-scripts/build_tsl_playbook.py}"
|
||||
COMMIT_AUTHOR_NAME="${COMMIT_AUTHOR_NAME:-ci[bot]}"
|
||||
COMMIT_AUTHOR_EMAIL="${COMMIT_AUTHOR_EMAIL:-ci-bot@local}"
|
||||
|
||||
cd "$REPO_DIR"
|
||||
|
||||
git config user.name "$COMMIT_AUTHOR_NAME"
|
||||
git config user.email "$COMMIT_AUTHOR_EMAIL"
|
||||
|
||||
source_sha="$(git rev-parse HEAD)"
|
||||
source_short="$(git rev-parse --short HEAD)"
|
||||
|
||||
# Build the bundle into a temp dir *outside* the repo so that resetting the
|
||||
# target branch's working tree can never clobber the freshly built artifact.
|
||||
build_dir="$(mktemp -d)"
|
||||
cleanup() {
|
||||
rm -rf "$build_dir"
|
||||
}
|
||||
trap cleanup EXIT
|
||||
|
||||
bundle="$build_dir/tsl-playbook"
|
||||
python3 "$BUILD_SCRIPT" --output "$bundle"
|
||||
|
||||
# Check out (or create) the target branch. It is a content-only branch that
|
||||
# shares no history with main, so an orphan branch keeps it clean.
|
||||
if git show-ref --verify --quiet "refs/remotes/origin/$TARGET_BRANCH"; then
|
||||
git fetch origin "$TARGET_BRANCH"
|
||||
git checkout -B "$TARGET_BRANCH" "origin/$TARGET_BRANCH"
|
||||
else
|
||||
git checkout --orphan "$TARGET_BRANCH"
|
||||
fi
|
||||
|
||||
# Replace the entire tracked tree with the bundle contents. `git rm` clears
|
||||
# tracked files; then copy the expanded bundle to the repo root.
|
||||
git rm -rf --quiet . >/dev/null 2>&1 || true
|
||||
|
||||
# Copy bundle contents (including dotfiles) to the repo root.
|
||||
cp -R "$bundle"/. "$REPO_DIR"/
|
||||
|
||||
git add -A
|
||||
|
||||
if git diff --cached --quiet; then
|
||||
echo "No tsl-playbook changes to publish."
|
||||
exit 0
|
||||
fi
|
||||
|
||||
git commit -m ":package: deps(tsl): sync tsl-playbook from ${source_short}
|
||||
|
||||
Source-Commit: ${source_sha}"
|
||||
|
||||
TOKEN="${WORKFLOW:-}"
|
||||
if [ -n "$TOKEN" ] && [ -n "${GITHUB_SERVER_URL:-}" ] && [ -n "${GITHUB_REPOSITORY:-}" ]; then
|
||||
git remote set-url origin "https://oauth2:${TOKEN}@${GITHUB_SERVER_URL#https://}/${GITHUB_REPOSITORY}.git"
|
||||
fi
|
||||
|
||||
git push origin "$TARGET_BRANCH"
|
||||
echo "✅ Published tsl-playbook @ ${source_short}"
|
||||
@@ -0,0 +1,68 @@
|
||||
name: 📦 Sync TSL Playbook
|
||||
|
||||
on:
|
||||
push:
|
||||
branches:
|
||||
- main
|
||||
workflow_dispatch:
|
||||
|
||||
concurrency:
|
||||
group: sync-tsl-playbook-${{ github.repository }}
|
||||
cancel-in-progress: true
|
||||
|
||||
env:
|
||||
WORKSPACE_DIR: "/home/workspace"
|
||||
TARGET_BRANCH: "tsl-playbook"
|
||||
|
||||
jobs:
|
||||
sync:
|
||||
name: 📦 Build and publish tsl-playbook
|
||||
runs-on: ubuntu-22.04
|
||||
|
||||
steps:
|
||||
- name: 📥 准备仓库
|
||||
shell: bash
|
||||
run: |
|
||||
set -euo pipefail
|
||||
|
||||
echo "========================================"
|
||||
echo "📦 准备仓库到 WORKSPACE_DIR"
|
||||
echo "========================================"
|
||||
|
||||
REPO_NAME="${{ github.event.repository.name }}"
|
||||
TOKEN="${{ secrets.WORKFLOW }}"
|
||||
mkdir -p "$WORKSPACE_DIR"
|
||||
REPO_DIR="$(mktemp -d "$WORKSPACE_DIR/${REPO_NAME}.XXXXXX")"
|
||||
if [ -n "$TOKEN" ]; then
|
||||
REPO_URL="https://oauth2:${TOKEN}@${GITHUB_SERVER_URL#https://}/${GITHUB_REPOSITORY}.git"
|
||||
else
|
||||
REPO_URL="${GITHUB_SERVER_URL}/${GITHUB_REPOSITORY}.git"
|
||||
fi
|
||||
|
||||
git clone "$REPO_URL" "$REPO_DIR"
|
||||
|
||||
git -C "$REPO_DIR" fetch origin main
|
||||
git -C "$REPO_DIR" checkout -B main origin/main
|
||||
|
||||
git config --global --add safe.directory "$REPO_DIR"
|
||||
echo "REPO_DIR=$REPO_DIR" >> "$GITHUB_ENV"
|
||||
echo "✅ 仓库准备完成"
|
||||
|
||||
- name: 📦 Build and publish tsl-playbook
|
||||
shell: bash
|
||||
env:
|
||||
WORKFLOW: ${{ secrets.WORKFLOW }}
|
||||
run: |
|
||||
set -euo pipefail
|
||||
cd "$REPO_DIR"
|
||||
|
||||
echo "========================================"
|
||||
echo "🔨 Build bundle and sync $TARGET_BRANCH"
|
||||
echo "========================================"
|
||||
|
||||
TARGET_BRANCH="$TARGET_BRANCH" bash .gitea/ci/sync_tsl_playbook.sh
|
||||
|
||||
- name: 🧹 清理临时仓库
|
||||
if: always()
|
||||
run: |
|
||||
rm -rf "$REPO_DIR"
|
||||
@@ -0,0 +1,96 @@
|
||||
#!/usr/bin/env python3
|
||||
"""Build the minimal TSL playbook bundle."""
|
||||
import argparse
|
||||
import shutil
|
||||
import sys
|
||||
from pathlib import Path
|
||||
|
||||
|
||||
DEFAULT_OUTPUT = Path("tmp") / "tsl-playbook"
|
||||
API_REFERENCE_BULLET = (
|
||||
"- 查 API / 函数的名字、参数、返回值和示例时，使用 "
|
||||
"`tsl-api-reference` skill；已知名走 `--name`，未知名走 `--kw`。"
|
||||
)
|
||||
|
||||
|
||||
def copy_tree(src: Path, dst: Path) -> None:
|
||||
shutil.copytree(src, dst)
|
||||
|
||||
|
||||
def build_agents_text(ruleset_path: Path) -> str:
|
||||
text = ruleset_path.read_text(encoding="utf-8")
|
||||
text = text.replace("# TSL 智能体规则", "# TSL Agent Instructions", 1)
|
||||
if API_REFERENCE_BULLET not in text:
|
||||
marker = (
|
||||
"- 需要任何 TSL 语法、文件模型、函数、模块或金融数据事实时，"
|
||||
"第一跳统一进 `docs/tsl/index.md`，由它路由到具体页；"
|
||||
"不在本文件内猜文件路径，也不全目录搜索。"
|
||||
)
|
||||
text = text.replace(marker, f"{marker}\n{API_REFERENCE_BULLET}", 1)
|
||||
return text.rstrip("\n") + "\n"
|
||||
|
||||
|
||||
def ensure_sources(repo_root: Path) -> tuple[Path, Path, Path]:
|
||||
docs_tsl = repo_root / "docs" / "tsl"
|
||||
skill = repo_root / "skills" / "tsl-api-reference"
|
||||
ruleset = repo_root / "rulesets" / "tsl" / "index.md"
|
||||
missing = [str(path) for path in (docs_tsl, skill, ruleset) if not path.exists()]
|
||||
if missing:
|
||||
raise FileNotFoundError("missing source path(s): " + ", ".join(missing))
|
||||
return docs_tsl, skill, ruleset
|
||||
|
||||
|
||||
def clean_output(output: Path, repo_root: Path) -> None:
|
||||
resolved = output.resolve()
|
||||
forbidden = {
|
||||
repo_root.resolve(),
|
||||
(repo_root / "docs").resolve(),
|
||||
(repo_root / "skills").resolve(),
|
||||
(repo_root / "rulesets").resolve(),
|
||||
}
|
||||
if resolved in forbidden:
|
||||
raise ValueError(f"refusing to replace source directory: {output}")
|
||||
if output.exists():
|
||||
shutil.rmtree(output)
|
||||
output.mkdir(parents=True)
|
||||
|
||||
|
||||
def build(output: Path, repo_root: Path) -> None:
|
||||
docs_tsl, skill, ruleset = ensure_sources(repo_root)
|
||||
clean_output(output, repo_root)
|
||||
|
||||
(output / "AGENTS.md").write_text(
|
||||
build_agents_text(ruleset), encoding="utf-8", newline="\n"
|
||||
)
|
||||
copy_tree(docs_tsl, output / "docs" / "tsl")
|
||||
copy_tree(skill, output / "skills" / "tsl-api-reference")
|
||||
|
||||
|
||||
def main(argv=None) -> int:
|
||||
if hasattr(sys.stdout, "reconfigure"):
|
||||
sys.stdout.reconfigure(encoding="utf-8")
|
||||
parser = argparse.ArgumentParser(description=__doc__)
|
||||
parser.add_argument(
|
||||
"--output",
|
||||
default=str(DEFAULT_OUTPUT),
|
||||
help=f"output directory (default: {DEFAULT_OUTPUT.as_posix()})",
|
||||
)
|
||||
args = parser.parse_args(argv)
|
||||
|
||||
repo_root = Path(__file__).resolve().parents[1]
|
||||
output = Path(args.output)
|
||||
if not output.is_absolute():
|
||||
output = repo_root / output
|
||||
|
||||
try:
|
||||
build(output, repo_root)
|
||||
except (FileNotFoundError, ValueError, OSError) as exc:
|
||||
print(f"ERROR: {exc}", file=sys.stderr)
|
||||
return 1
|
||||
|
||||
print(f"wrote {output}")
|
||||
return 0
|
||||
|
||||
|
||||
if __name__ == "__main__":
|
||||
raise SystemExit(main())
|
||||
@@ -0,0 +1,67 @@
|
||||
import subprocess
|
||||
import sys
|
||||
import tempfile
|
||||
import unittest
|
||||
from pathlib import Path
|
||||
|
||||
|
||||
ROOT = Path(__file__).resolve().parents[1]
|
||||
SCRIPT = ROOT / "scripts" / "build_tsl_playbook.py"
|
||||
|
||||
|
||||
class BuildTslPlaybookTests(unittest.TestCase):
|
||||
def test_builds_minimal_tsl_playbook_tree(self):
|
||||
with tempfile.TemporaryDirectory() as tmp_dir:
|
||||
output = Path(tmp_dir) / "tsl-playbook"
|
||||
|
||||
result = subprocess.run(
|
||||
[sys.executable, str(SCRIPT), "--output", str(output)],
|
||||
capture_output=True,
|
||||
text=True,
|
||||
)
|
||||
|
||||
self.assertEqual(result.returncode, 0, msg=result.stderr)
|
||||
self.assertEqual(
|
||||
sorted(path.name for path in output.iterdir()),
|
||||
["AGENTS.md", "docs", "skills"],
|
||||
)
|
||||
self.assertFalse((output / "playbook.toml").exists())
|
||||
self.assertFalse((output / ".agents").exists())
|
||||
self.assertFalse((output / "docs" / "index.md").exists())
|
||||
|
||||
self.assertTrue((output / "docs" / "tsl" / "index.md").is_file())
|
||||
self.assertTrue(
|
||||
(output / "skills" / "tsl-api-reference" / "SKILL.md").is_file()
|
||||
)
|
||||
self.assertTrue(
|
||||
(
|
||||
output
|
||||
/ "skills"
|
||||
/ "tsl-api-reference"
|
||||
/ "scripts"
|
||||
/ "lookup.py"
|
||||
).is_file()
|
||||
)
|
||||
|
||||
agents_text = (output / "AGENTS.md").read_text(encoding="utf-8")
|
||||
self.assertIn("# TSL Agent Instructions", agents_text)
|
||||
self.assertIn("docs/tsl/index.md", agents_text)
|
||||
self.assertIn("tsl-api-reference", agents_text)
|
||||
self.assertNotIn(".agents/index.md", agents_text)
|
||||
self.assertNotIn(".agents/tsl/index.md", agents_text)
|
||||
|
||||
source_docs = count_files(ROOT / "docs" / "tsl")
|
||||
output_docs = count_files(output / "docs" / "tsl")
|
||||
self.assertEqual(output_docs, source_docs)
|
||||
|
||||
source_skill = count_files(ROOT / "skills" / "tsl-api-reference")
|
||||
output_skill = count_files(output / "skills" / "tsl-api-reference")
|
||||
self.assertEqual(output_skill, source_skill)
|
||||
|
||||
|
||||
def count_files(path: Path) -> int:
|
||||
return sum(1 for item in path.rglob("*") if item.is_file())
|
||||
|
||||
|
||||
if __name__ == "__main__":
|
||||
unittest.main()
|
||||
Reference in New Issue
Block a user