first commit

This commit is contained in:
2026-07-22 13:48:46 +08:00
commit c87751c3dc
2820 changed files with 726976 additions and 0 deletions
+57
View File
@@ -0,0 +1,57 @@
#!/usr/bin/env bash
set -euo pipefail
SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
REPO_ROOT="$(cd "$SCRIPT_DIR/../.." && pwd)"
LIST_SKILLS_SCRIPT="$REPO_ROOT/scripts/utils/list-skills.sh"
UTILS_SCRIPT="$SCRIPT_DIR/symlink-utils.sh"
MODE="write"
usage() {
cat <<'EOF'
Usage:
scripts/dev/setup-plugin-symlink.sh [--check]
Sets up plugins/cad/skills as symlinks to root skills/* for development.
Options:
--check Verify plugin development symlinks are intact without changing files.
-h, --help Show this help.
EOF
}
while [ "$#" -gt 0 ]; do
case "$1" in
--check)
MODE="check"
;;
-h|--help)
usage
exit 0
;;
*)
echo "Unknown argument: $1" >&2
usage >&2
exit 2
;;
esac
shift
done
if [ ! -x "$LIST_SKILLS_SCRIPT" ]; then
echo "Missing skill list script: $LIST_SKILLS_SCRIPT" >&2
exit 1
fi
# shellcheck source=scripts/dev/symlink-utils.sh
source "$UTILS_SCRIPT"
cd "$REPO_ROOT"
if [ "$MODE" != "check" ]; then
mkdir -p "plugins/cad/skills"
fi
while IFS= read -r skill; do
setup_link "$MODE" "plugins/cad/skills/$skill" "../../../skills/$skill"
done < <("$LIST_SKILLS_SCRIPT")
+81
View File
@@ -0,0 +1,81 @@
#!/usr/bin/env bash
set -euo pipefail
SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
REPO_ROOT="$(cd "$SCRIPT_DIR/../.." && pwd)"
SKILL_SYMLINK_DIR="$SCRIPT_DIR/skills"
usage() {
cat <<'EOF'
Usage:
scripts/dev/setup-skill-symlink.sh <skill-id> [skill-symlink-args...]
scripts/dev/setup-skill-symlink.sh --all [shared-skill-symlink-args...]
Sets up development symlinks for one skill. Skill IDs map to
scripts/dev/skills/setup-<skill-id>-skill-symlink.sh.
Options:
--all Run every skill symlink setup script under scripts/dev/skills.
-h, --help Show this help.
Skill-specific arguments are passed through to the selected setup script.
If a skill has no symlink setup script, this command fails.
EOF
}
list_linkable_skills() {
find "$SKILL_SYMLINK_DIR" -maxdepth 1 -type f -name 'setup-*-skill-symlink.sh' -print |
while IFS= read -r script; do
basename "$script" | sed -e 's/^setup-//' -e 's/-skill-symlink\.sh$//'
done |
LC_ALL=C sort
}
run_skill_setup() {
local skill_id="$1"
shift
local setup_script="$SKILL_SYMLINK_DIR/setup-$skill_id-skill-symlink.sh"
if [ ! -f "$REPO_ROOT/skills/$skill_id/SKILL.md" ]; then
echo "Unknown skill: $skill_id" >&2
echo "Known skills:" >&2
"$REPO_ROOT/scripts/utils/list-skills.sh" | sed 's/^/- /' >&2
exit 1
fi
if [ ! -x "$setup_script" ]; then
echo "Skill has no development symlink setup: $skill_id" >&2
echo "Expected setup script: ${setup_script#$REPO_ROOT/}" >&2
exit 1
fi
"$setup_script" "$@"
}
if [ "$#" -eq 0 ]; then
usage >&2
exit 2
fi
case "$1" in
-h|--help)
usage
exit 0
;;
--all)
shift
while IFS= read -r skill_id; do
run_skill_setup "$skill_id" "$@"
done < <(list_linkable_skills)
;;
-*)
echo "Unknown option: $1" >&2
usage >&2
exit 2
;;
*)
skill_id="$1"
shift
run_skill_setup "$skill_id" "$@"
;;
esac
+73
View File
@@ -0,0 +1,73 @@
#!/usr/bin/env bash
set -euo pipefail
SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
REPO_ROOT="$(cd "$SCRIPT_DIR/../.." && pwd)"
MODE="write"
SKILL_ARGS=()
PLUGIN_ARGS=()
usage() {
cat <<'EOF'
Usage:
scripts/dev/setup-symlinks.sh [--check]
Sets up the development symlink layout by replacing production bundle outputs
with links to their canonical source paths.
Options:
--check Verify development symlinks are intact without changing files.
-h, --help Show this help.
EOF
}
while [ "$#" -gt 0 ]; do
case "$1" in
--check)
MODE="check"
SKILL_ARGS+=("--check")
PLUGIN_ARGS+=("--check")
;;
-h|--help)
usage
exit 0
;;
*)
echo "Unknown argument: $1" >&2
usage >&2
exit 2
;;
esac
shift
done
cd "$REPO_ROOT"
if [ "$MODE" = "check" ]; then
echo "Checking skill development symlinks..."
else
echo "Setting up skill development symlinks..."
fi
if [ "${#SKILL_ARGS[@]}" -gt 0 ]; then
"$SCRIPT_DIR/setup-skill-symlink.sh" --all "${SKILL_ARGS[@]}"
else
"$SCRIPT_DIR/setup-skill-symlink.sh" --all
fi
if [ "$MODE" = "check" ]; then
echo "Checking plugin development symlinks..."
else
echo "Setting up plugin development symlinks..."
fi
if [ "${#PLUGIN_ARGS[@]}" -gt 0 ]; then
"$SCRIPT_DIR/setup-plugin-symlink.sh" "${PLUGIN_ARGS[@]}"
else
"$SCRIPT_DIR/setup-plugin-symlink.sh"
fi
if [ "$MODE" = "check" ]; then
echo "Development symlink layout is valid."
else
echo "Development symlink layout is ready."
fi
@@ -0,0 +1,45 @@
#!/usr/bin/env bash
set -euo pipefail
SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
REPO_ROOT="$(cd "$SCRIPT_DIR/../../.." && pwd)"
UTILS_SCRIPT="$REPO_ROOT/scripts/dev/symlink-utils.sh"
MODE="write"
usage() {
cat <<'EOF'
Usage:
scripts/dev/setup-skill-symlink.sh cad [--check]
Sets up CAD skill development symlinks.
Options:
--check Verify symlinks are intact without changing files.
-h, --help Show this help.
EOF
}
while [ "$#" -gt 0 ]; do
case "$1" in
--check)
MODE="check"
;;
-h|--help)
usage
exit 0
;;
*)
echo "Unknown argument: $1" >&2
usage >&2
exit 2
;;
esac
shift
done
# shellcheck source=scripts/dev/symlink-utils.sh
source "$UTILS_SCRIPT"
cd "$REPO_ROOT"
setup_link "$MODE" "skills/cad/scripts/packages/cadpy" "../../../../packages/cadpy"
@@ -0,0 +1,68 @@
#!/usr/bin/env bash
set -euo pipefail
SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
REPO_ROOT="$(cd "$SCRIPT_DIR/../../.." && pwd)"
UTILS_SCRIPT="$REPO_ROOT/scripts/dev/symlink-utils.sh"
MODE="write"
usage() {
cat <<'EOF'
Usage:
scripts/dev/setup-skill-symlink.sh cad-viewer [--check]
Sets up CAD Viewer development symlinks.
Options:
--check Verify symlinks are intact without changing files.
-h, --help Show this help.
EOF
}
while [ "$#" -gt 0 ]; do
case "$1" in
--check)
MODE="check"
;;
-h|--help)
usage
exit 0
;;
*)
echo "Unknown argument: $1" >&2
usage >&2
exit 2
;;
esac
shift
done
# shellcheck source=scripts/dev/symlink-utils.sh
source "$UTILS_SCRIPT"
check_no_tracked_runtime_dist() {
local tracked_dist
tracked_dist="$(
git ls-files \
"skills/cad-viewer/scripts/viewer/dist" \
"skills/cad-viewer/scripts/viewer/dist/**" \
2>/dev/null || true
)"
if [ -n "$tracked_dist" ]; then
echo "skills/cad-viewer/scripts/viewer/dist must not be tracked on develop." >&2
echo "Run scripts/dev/setup-symlinks.sh to restore the cad-viewer runtime symlink." >&2
echo "$tracked_dist" | sed 's/^/- /' >&2
return 1
fi
}
cd "$REPO_ROOT"
setup_link "$MODE" "viewer/packages/cadjs" "../../packages/cadjs"
setup_link "$MODE" "viewer/packages/cadpy" "../../packages/cadpy"
setup_link "$MODE" "viewer/packages/implicitjs" "../../packages/implicitjs"
setup_link "$MODE" "skills/cad-viewer/scripts/viewer" "../../../viewer"
if [ "$MODE" = "check" ]; then
check_no_tracked_runtime_dist
fi
@@ -0,0 +1,45 @@
#!/usr/bin/env bash
set -euo pipefail
SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
REPO_ROOT="$(cd "$SCRIPT_DIR/../../.." && pwd)"
UTILS_SCRIPT="$REPO_ROOT/scripts/dev/symlink-utils.sh"
MODE="write"
usage() {
cat <<'EOF'
Usage:
scripts/dev/setup-skill-symlink.sh dxf [--check]
Sets up DXF skill development symlinks.
Options:
--check Verify symlinks are intact without changing files.
-h, --help Show this help.
EOF
}
while [ "$#" -gt 0 ]; do
case "$1" in
--check)
MODE="check"
;;
-h|--help)
usage
exit 0
;;
*)
echo "Unknown argument: $1" >&2
usage >&2
exit 2
;;
esac
shift
done
# shellcheck source=scripts/dev/symlink-utils.sh
source "$UTILS_SCRIPT"
cd "$REPO_ROOT"
setup_link "$MODE" "skills/dxf/scripts/packages/cadpy" "../../../../packages/cadpy"
@@ -0,0 +1,67 @@
#!/usr/bin/env bash
set -euo pipefail
SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
REPO_ROOT="$(cd "$SCRIPT_DIR/../../.." && pwd)"
UTILS_SCRIPT="$REPO_ROOT/scripts/dev/symlink-utils.sh"
MODE="write"
usage() {
cat <<'EOF'
Usage:
scripts/dev/setup-skill-symlink.sh implicit-cad [--check]
Sets up Implicit CAD skill development symlinks.
Options:
--check Verify symlinks are intact without changing files.
-h, --help Show this help.
EOF
}
while [ "$#" -gt 0 ]; do
case "$1" in
--check)
MODE="check"
;;
-h|--help)
usage
exit 0
;;
*)
echo "Unknown argument: $1" >&2
usage >&2
exit 2
;;
esac
shift
done
# shellcheck source=scripts/dev/symlink-utils.sh
source "$UTILS_SCRIPT"
check_no_generated_runtimes() {
local tracked_runtime
tracked_runtime="$(
git ls-files \
"skills/implicit-cad/scripts/export/runtime" \
"skills/implicit-cad/scripts/export/runtime/**" \
"skills/implicit-cad/scripts/snapshot/runtime" \
"skills/implicit-cad/scripts/snapshot/runtime/**" \
2>/dev/null || true
)"
if [ -n "$tracked_runtime" ]; then
echo "Implicit CAD generated runtimes must not be tracked on develop." >&2
echo "Run scripts/dev/setup-symlinks.sh to restore the implicit-cad development layout." >&2
echo "$tracked_runtime" | sed 's/^/- /' >&2
return 1
fi
}
cd "$REPO_ROOT"
setup_link "$MODE" "skills/implicit-cad/scripts/packages/implicitjs" "../../../../packages/implicitjs"
if [ "$MODE" = "check" ]; then
check_no_generated_runtimes
fi
@@ -0,0 +1,45 @@
#!/usr/bin/env bash
set -euo pipefail
SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
REPO_ROOT="$(cd "$SCRIPT_DIR/../../.." && pwd)"
UTILS_SCRIPT="$REPO_ROOT/scripts/dev/symlink-utils.sh"
MODE="write"
usage() {
cat <<'EOF'
Usage:
scripts/dev/setup-skill-symlink.sh sdf [--check]
Sets up SDF skill development symlinks.
Options:
--check Verify symlinks are intact without changing files.
-h, --help Show this help.
EOF
}
while [ "$#" -gt 0 ]; do
case "$1" in
--check)
MODE="check"
;;
-h|--help)
usage
exit 0
;;
*)
echo "Unknown argument: $1" >&2
usage >&2
exit 2
;;
esac
shift
done
# shellcheck source=scripts/dev/symlink-utils.sh
source "$UTILS_SCRIPT"
cd "$REPO_ROOT"
setup_link "$MODE" "skills/sdf/scripts/packages/cadpy_metadata" "../../../../packages/cadpy_metadata"
@@ -0,0 +1,45 @@
#!/usr/bin/env bash
set -euo pipefail
SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
REPO_ROOT="$(cd "$SCRIPT_DIR/../../.." && pwd)"
UTILS_SCRIPT="$REPO_ROOT/scripts/dev/symlink-utils.sh"
MODE="write"
usage() {
cat <<'EOF'
Usage:
scripts/dev/setup-skill-symlink.sh srdf [--check]
Sets up SRDF skill development symlinks.
Options:
--check Verify symlinks are intact without changing files.
-h, --help Show this help.
EOF
}
while [ "$#" -gt 0 ]; do
case "$1" in
--check)
MODE="check"
;;
-h|--help)
usage
exit 0
;;
*)
echo "Unknown argument: $1" >&2
usage >&2
exit 2
;;
esac
shift
done
# shellcheck source=scripts/dev/symlink-utils.sh
source "$UTILS_SCRIPT"
cd "$REPO_ROOT"
setup_link "$MODE" "skills/srdf/scripts/packages/cadpy_metadata" "../../../../packages/cadpy_metadata"
@@ -0,0 +1,45 @@
#!/usr/bin/env bash
set -euo pipefail
SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
REPO_ROOT="$(cd "$SCRIPT_DIR/../../.." && pwd)"
UTILS_SCRIPT="$REPO_ROOT/scripts/dev/symlink-utils.sh"
MODE="write"
usage() {
cat <<'EOF'
Usage:
scripts/dev/setup-skill-symlink.sh urdf [--check]
Sets up URDF skill development symlinks.
Options:
--check Verify symlinks are intact without changing files.
-h, --help Show this help.
EOF
}
while [ "$#" -gt 0 ]; do
case "$1" in
--check)
MODE="check"
;;
-h|--help)
usage
exit 0
;;
*)
echo "Unknown argument: $1" >&2
usage >&2
exit 2
;;
esac
shift
done
# shellcheck source=scripts/dev/symlink-utils.sh
source "$UTILS_SCRIPT"
cd "$REPO_ROOT"
setup_link "$MODE" "skills/urdf/scripts/packages/cadpy_metadata" "../../../../packages/cadpy_metadata"
+53
View File
@@ -0,0 +1,53 @@
#!/usr/bin/env bash
link_path() {
local path="$1"
local target="$2"
if [ -L "$path" ] && [ "$(readlink "$path")" = "$target" ]; then
echo "Already linked $path -> $target"
return
fi
if [ -e "$path" ] || [ -L "$path" ]; then
rm -rf "$path"
fi
mkdir -p "$(dirname "$path")"
ln -s "$target" "$path"
echo "Linked $path -> $target"
}
check_link() {
local path="$1"
local expected_target="$2"
local actual_target
if [ ! -L "$path" ]; then
echo "$path must be a symlink to $expected_target" >&2
return 1
fi
actual_target="$(readlink "$path")"
if [ "$actual_target" != "$expected_target" ]; then
echo "$path points to $actual_target, expected $expected_target" >&2
return 1
fi
if [ ! -e "$path" ]; then
echo "$path points to missing target $expected_target" >&2
return 1
fi
}
setup_link() {
local mode="$1"
local path="$2"
local target="$3"
if [ "$mode" = "check" ]; then
check_link "$path" "$target"
else
link_path "$path" "$target"
fi
}