@kafka0102/onespec 0.1.2

package/assets/skills/onespec/scripts/onespec-commit.sh

@@ -0,0 +1,444 @@
+#!/usr/bin/env bash
+set -euo pipefail
+
+die() {
+  echo "ERROR: $*" >&2
+  exit 1
+}
+
+valid_change() {
+  local change="$1"
+  [[ -n "$change" ]] || die "change name is required"
+  [[ "$change" =~ ^[A-Za-z0-9][A-Za-z0-9._-]*$ ]] || die "invalid change name: $change"
+  [[ "$change" != *".."* ]] || die "change name must not contain '..'"
+}
+
+change_dir() {
+  local change="$1"
+  if [ -d "openspec/changes/$change" ]; then
+    printf 'openspec/changes/%s\n' "$change"
+  elif [ -d "openspec/changes/archive/$change" ]; then
+    printf 'openspec/changes/archive/%s\n' "$change"
+  else
+    printf 'openspec/changes/%s\n' "$change"
+  fi
+}
+
+state_file() {
+  local change="$1"
+  printf '%s/.onespec.yaml\n' "$(change_dir "$change")"
+}
+
+normalize_path() {
+  local input="$1"
+  local normalized="${input#./}"
+  [[ -n "$normalized" ]] || die "path must not be empty"
+  [[ "$normalized" != .*"/../"* ]] || die "path must not contain parent traversal: $input"
+  [[ "$normalized" != ../* ]] || die "path must not contain parent traversal: $input"
+  [[ "$normalized" != *"/.." ]] || die "path must not contain parent traversal: $input"
+  printf '%s\n' "$normalized"
+}
+
+sort_unique_lines() {
+  awk 'NF && !seen[$0]++ { print $0 }'
+}
+
+field_value() {
+  local file="$1"
+  local key="$2"
+  awk -F ': *' -v key="$key" '$1 == key { sub(/^[^:]+: */, ""); print; found=1; exit } END { if (!found) exit 0 }' "$file" 2>/dev/null
+}
+
+set_field() {
+  local file="$1"
+  local key="$2"
+  local value="$3"
+  local tmp
+  tmp="$(mktemp)"
+  if grep -q "^${key}:" "$file"; then
+    awk -v key="$key" -v value="$value" '
+      $0 ~ "^" key ":" { print key ": " value; next }
+      { print }
+    ' "$file" > "$tmp"
+  else
+    cat "$file" > "$tmp"
+    printf '%s: %s\n' "$key" "$value" >> "$tmp"
+  fi
+  mv "$tmp" "$file"
+}
+
+encode_base64() {
+  base64 | tr -d '\n'
+}
+
+decode_base64() {
+  if base64 --help >/dev/null 2>&1; then
+    base64 --decode 2>/dev/null || base64 -d 2>/dev/null || base64 -D
+  else
+    base64 -d 2>/dev/null || base64 -D
+  fi
+}
+
+load_tracked_lines() {
+  local change="$1"
+  local file encoded
+  file="$(state_file "$change")"
+  [ -f "$file" ] || return 0
+  encoded="$(field_value "$file" touched_files_b64)"
+  if [ -z "$encoded" ] || [ "$encoded" = "null" ]; then
+    return 0
+  fi
+  printf '%s' "$encoded" | decode_base64
+}
+
+save_tracked_lines() {
+  local change="$1"
+  local file="$2"
+  local state encoded
+  state="$(state_file "$change")"
+  [ -f "$state" ] || die "state not found: $state"
+  if [ ! -s "$file" ]; then
+    set_field "$state" touched_files_b64 "null"
+    return 0
+  fi
+  encoded="$(encode_base64 < "$file")"
+  set_field "$state" touched_files_b64 "$encoded"
+}
+
+ensure_git_repo() {
+  git rev-parse --show-toplevel >/dev/null 2>&1 || die "current directory is not inside a git repository"
+}
+
+git_dirty_paths() {
+  git status --porcelain=v1 --untracked-files=all | awk '
+    {
+      path = substr($0, 4)
+      sub(/^.* -> /, "", path)
+      if (length(path) > 0) {
+        print path
+      }
+    }
+  '
+}
+
+dirty_change_artifact_paths() {
+  local change="$1"
+  local dir
+  dir="$(change_dir "$change")"
+  git_dirty_paths | awk -v prefix="$dir/" 'index($0, prefix) == 1 { print }'
+}
+
+repo_layout() {
+  if [ -f "pnpm-workspace.yaml" ] || [ -f "nx.json" ] || [ -f "turbo.json" ] || [ -f "lerna.json" ] || [ -f "go.work" ] || [ -f "settings.gradle" ] || [ -f "settings.gradle.kts" ]; then
+    echo "multi"
+    return 0
+  fi
+  if [ -f "package.json" ] && grep -Eq '"workspaces"[[:space:]]*:' package.json; then
+    echo "multi"
+    return 0
+  fi
+  if [ -f "Cargo.toml" ] && grep -Eq '^\[workspace\]' Cargo.toml; then
+    echo "multi"
+    return 0
+  fi
+  if [ -f "pom.xml" ] && grep -Eq '<modules>' pom.xml; then
+    echo "multi"
+    return 0
+  fi
+  echo "single"
+}
+
+find_policy_doc() {
+  local pattern='提交|commit message|commit messages|提交信息|提交规范|提交格式|conventional commit|conventional commits|git workflow|commitlint|commitizen'
+  local file
+
+  for file in AGENTS.md CONTRIBUTING.md CONTRIBUTING.zh-CN.md README.md README-zh.md README.en.md; do
+    if [ -f "$file" ] && grep -Eiq "$pattern" "$file"; then
+      printf '%s\n' "$file"
+      return 0
+    fi
+  done
+
+  if [ -d docs ]; then
+    while IFS= read -r file; do
+      if grep -Eiq "$pattern" "$file"; then
+        printf '%s\n' "$file"
+        return 0
+      fi
+    done < <(find docs -type f \( -name '*.md' -o -name '*.txt' \) | sort)
+  fi
+
+  return 1
+}
+
+find_commit_config() {
+  local file
+
+  for file in \
+    commitlint.config.js \
+    commitlint.config.cjs \
+    commitlint.config.mjs \
+    commitlint.config.ts \
+    .commitlintrc \
+    .commitlintrc.json \
+    .commitlintrc.yml \
+    .commitlintrc.yaml \
+    .commitlintrc.js \
+    .commitlintrc.cjs \
+    .czrc
+  do
+    if [ -f "$file" ]; then
+      printf '%s\n' "$file"
+      return 0
+    fi
+  done
+
+  if [ -f "package.json" ] && grep -Eiq '"(commitlint|commitizen)"[[:space:]]*:' package.json; then
+    echo "package.json"
+    return 0
+  fi
+
+  return 1
+}
+
+detect_language_from_doc() {
+  local file="$1"
+
+  if grep -Eiq '简体中文|中文 conventional|中文提交|提交标题.*中文|描述.*中文' "$file"; then
+    echo "zh"
+    return 0
+  fi
+  if grep -Eiq 'english|commit message.*english|description.*english' "$file"; then
+    echo "en"
+    return 0
+  fi
+  if grep -q '[一-龥]' "$file"; then
+    echo "zh"
+    return 0
+  fi
+  echo "unknown"
+}
+
+detect_format_from_file() {
+  local file="$1"
+
+  if grep -Eiq '<type>\(<scope>\):|conventional commit|conventional commits|commitlint|type\(scope\)' "$file"; then
+    echo "conventional"
+    return 0
+  fi
+  echo "unknown"
+}
+
+infer_scope() {
+  local change="${1:-}"
+  local tracked
+
+  if [ -z "$change" ]; then
+    echo "repo"
+    return 0
+  fi
+
+  tracked="$(mktemp)"
+  load_tracked_lines "$change" > "$tracked"
+  if [ ! -s "$tracked" ]; then
+    rm -f "$tracked"
+    echo "repo"
+    return 0
+  fi
+
+  awk -F/ '
+    function scope_for(path, first, second) {
+      first = $1
+      second = $2
+      if (first == "packages" || first == "apps" || first == "services" || first == "libs") {
+        return second != "" ? second : "repo"
+      }
+      if (first == "docs" || first == "openspec") {
+        return "docs"
+      }
+      if (second == "") {
+        return "repo"
+      }
+      return first
+    }
+    {
+      candidate = scope_for($0)
+      seen[candidate] = 1
+    }
+    END {
+      count = 0
+      for (key in seen) {
+        choice = key
+        count++
+      }
+      if (count == 1) {
+        print choice
+      } else {
+        print "repo"
+      }
+    }
+  ' "$tracked"
+  rm -f "$tracked"
+}
+
+cmd_track() {
+  local change="$1"
+  shift
+  valid_change "$change"
+  [ "$#" -gt 0 ] || die "track requires at least one path"
+
+  local tracked tmp path
+  tracked="$(mktemp)"
+  tmp="$(mktemp)"
+
+  load_tracked_lines "$change" > "$tmp"
+
+  for path in "$@"; do
+    normalize_path "$path" >> "$tmp"
+  done
+
+  sort_unique_lines < "$tmp" > "$tracked"
+  save_tracked_lines "$change" "$tracked"
+  cat "$tracked"
+  rm -f "$tmp" "$tracked"
+}
+
+cmd_tracked() {
+  local change="$1"
+  valid_change "$change"
+  load_tracked_lines "$change"
+}
+
+cmd_related_dirty() {
+  local change="$1"
+  valid_change "$change"
+  ensure_git_repo
+
+  local tracked state dirty artifacts
+  tracked="$(mktemp)"
+  dirty="$(mktemp)"
+  artifacts="$(mktemp)"
+  load_tracked_lines "$change" > "$tracked"
+  state="$(state_file "$change")"
+  git_dirty_paths | sort_unique_lines > "$dirty"
+  dirty_change_artifact_paths "$change" | sort_unique_lines > "$artifacts"
+
+  if grep -Fxq "$state" "$dirty"; then
+    printf '%s\n' "$state" >> "$tracked"
+  fi
+
+  if [ -s "$artifacts" ]; then
+    cat "$artifacts" >> "$tracked"
+  fi
+
+  sort_unique_lines < "$tracked" > "${tracked}.sorted"
+  mv "${tracked}.sorted" "$tracked"
+
+  if [ ! -s "$tracked" ]; then
+    rm -f "$tracked" "$dirty" "$artifacts"
+    return 0
+  fi
+
+  awk 'NR==FNR { dirty[$0] = 1; next } dirty[$0] { print $0 }' "$dirty" "$tracked" | sort_unique_lines
+  rm -f "$tracked" "$dirty" "$artifacts"
+}
+
+cmd_stage_related() {
+  local change="$1"
+  valid_change "$change"
+  ensure_git_repo
+
+  local -a files=()
+  local file
+  while IFS= read -r file; do
+    files+=("$file")
+  done < <(cmd_related_dirty "$change")
+  if [ "${#files[@]}" -eq 0 ]; then
+    return 0
+  fi
+
+  git add -A -- "${files[@]}"
+  printf '%s\n' "${files[@]}"
+}
+
+cmd_detect_policy() {
+  local change="${1:-}"
+  local layout source origin format language confidence scope
+
+  layout="$(repo_layout)"
+  scope="$(infer_scope "$change")"
+  confidence="default"
+  origin="default"
+  source="default"
+  format="conventional"
+  language="en"
+
+  if source="$(find_policy_doc)"; then
+    origin="project-doc"
+    confidence="explicit"
+    format="$(detect_format_from_file "$source")"
+    language="$(detect_language_from_doc "$source")"
+    [ "$format" != "unknown" ] || format="conventional"
+    [ "$language" != "unknown" ] || language="en"
+  else
+    local config_source
+    if config_source="$(find_commit_config)"; then
+      source="$config_source"
+      origin="project-config"
+      confidence="partial"
+      format="conventional"
+      language="en"
+    fi
+  fi
+
+  cat <<EOF
+policy_source: $source
+policy_origin: $origin
+policy_confidence: $confidence
+commit_format: $format
+message_language: $language
+repo_layout: $layout
+scope_hint: $scope
+template: <type>(<scope>): <summary>
+EOF
+}
+
+usage() {
+  cat <<'EOF'
+用法:
+  onespec-commit.sh track <change> <path>...
+  onespec-commit.sh tracked <change>
+  onespec-commit.sh related-dirty <change>
+  onespec-commit.sh stage-related <change>
+  onespec-commit.sh detect-policy [change]
+EOF
+}
+
+cmd="${1:-}"
+case "$cmd" in
+  track)
+    [ "$#" -ge 3 ] || { usage; exit 2; }
+    shift
+    cmd_track "$@"
+    ;;
+  tracked)
+    [ "$#" -eq 2 ] || { usage; exit 2; }
+    cmd_tracked "$2"
+    ;;
+  related-dirty)
+    [ "$#" -eq 2 ] || { usage; exit 2; }
+    cmd_related_dirty "$2"
+    ;;
+  stage-related)
+    [ "$#" -eq 2 ] || { usage; exit 2; }
+    cmd_stage_related "$2"
+    ;;
+  detect-policy)
+    [ "$#" -le 2 ] || { usage; exit 2; }
+    cmd_detect_policy "${2:-}"
+    ;;
+  *)
+    usage
+    exit 2
+    ;;
+esac

package/assets/skills/onespec/scripts/onespec-env.sh

@@ -0,0 +1,15 @@
+#!/usr/bin/env bash
+
+_onespec_env_source="${BASH_SOURCE[0]:-$0}"
+_onespec_script_dir="$(cd "$(dirname "$_onespec_env_source")" && pwd -P)"
+
+export ONESPEC_STATE="${ONESPEC_STATE:-${_onespec_script_dir}/onespec-state.sh}"
+export ONESPEC_HANDOFF="${ONESPEC_HANDOFF:-${_onespec_script_dir}/onespec-handoff.sh}"
+export ONESPEC_COMMIT="${ONESPEC_COMMIT:-${_onespec_script_dir}/onespec-commit.sh}"
+export ONESPEC_CLOSEOUT="${ONESPEC_CLOSEOUT:-${_onespec_script_dir}/onespec-closeout.sh}"
+export ONESPEC_BASH="${ONESPEC_BASH:-${BASH:-bash}}"
+
+if [ ! -f "$ONESPEC_STATE" ] || [ ! -f "$ONESPEC_HANDOFF" ] || [ ! -f "$ONESPEC_COMMIT" ] || [ ! -f "$ONESPEC_CLOSEOUT" ]; then
+  echo "ERROR: OneSpec scripts are incomplete. Re-run onespec init --overwrite." >&2
+  return 1 2>/dev/null || exit 1
+fi

package/assets/skills/onespec/scripts/onespec-handoff.sh

@@ -0,0 +1,115 @@
+#!/usr/bin/env bash
+set -euo pipefail
+
+die() {
+  echo "ERROR: $*" >&2
+  exit 1
+}
+
+hash_file() {
+  if command -v shasum >/dev/null 2>&1; then
+    shasum -a 256 "$1" | awk '{print $1}'
+  elif command -v sha256sum >/dev/null 2>&1; then
+    sha256sum "$1" | awk '{print $1}'
+  else
+    die "shasum or sha256sum is required"
+  fi
+}
+
+hash_text() {
+  if command -v shasum >/dev/null 2>&1; then
+    shasum -a 256 | awk '{print $1}'
+  elif command -v sha256sum >/dev/null 2>&1; then
+    sha256sum | awk '{print $1}'
+  else
+    die "shasum or sha256sum is required"
+  fi
+}
+
+json_escape() {
+  sed 's/\\/\\\\/g; s/"/\\"/g' <<<"$1"
+}
+
+valid_change() {
+  local change="$1"
+  [[ -n "$change" ]] || die "change name is required"
+  [[ "$change" =~ ^[A-Za-z0-9][A-Za-z0-9._-]*$ ]] || die "invalid change name: $change"
+  [[ "$change" != *".."* ]] || die "change name must not contain '..'"
+}
+
+source_files() {
+  for file in "$change_dir/proposal.md" "$change_dir/design.md" "$change_dir/tasks.md"; do
+    [ -f "$file" ] && printf '%s\n' "$file"
+  done
+  if [ -d "$change_dir/specs" ]; then
+    find "$change_dir/specs" -path '*/spec.md' -type f | sort
+  fi
+}
+
+context_hash() {
+  source_files | while IFS= read -r file; do
+    printf '%s %s\n' "$(hash_file "$file")" "$file"
+  done | hash_text
+}
+
+summary_text() {
+  local files count first
+  files="$(source_files)"
+  count="$(printf '%s\n' "$files" | sed '/^$/d' | wc -l | tr -d ' ')"
+  first="$(printf '%s\n' "$files" | sed -n '1p')"
+  printf '%s handoff from %s file(s); primary artifact: %s' "$purpose" "$count" "$first"
+}
+
+write_excerpt() {
+  local file="$1"
+  local max_lines=100
+  local lines
+  lines="$(wc -l < "$file" | tr -d ' ')"
+  echo "## $file"
+  echo
+  echo "- sha256: $(hash_file "$file")"
+  echo "- lines: $lines"
+  echo
+  if [ "$mode" = "full" ] || [ "$lines" -le "$max_lines" ]; then
+    echo '```md'
+    cat "$file"
+    echo '```'
+  else
+    echo "[TRUNCATED: first ${max_lines} lines only]"
+    echo
+    echo '```md'
+    sed -n "1,${max_lines}p" "$file"
+    echo '```'
+  fi
+  echo
+}
+
+change="${1:-}"
+purpose="${2:-}"
+action="${3:-}"
+full_flag="${4:-}"
+
+[ "$action" = "--write" ] || die "usage: onespec-handoff.sh <change> <purpose> --write [--full]"
+valid_change "$change"
+case "$purpose" in proposal|plan|review|archive) ;; *) die "purpose must be proposal, plan, review, or archive" ;; esac
+case "$full_flag" in "" ) mode="compact" ;; "--full" ) mode="full" ;; * ) die "unknown option: $full_flag" ;; esac
+
+change_dir="openspec/changes/$change"
+state="$change_dir/.onespec.yaml"
+[ -d "$change_dir" ] || die "change directory not found: $change_dir"
+[ -f "$state" ] || die "state file not found: $state"
+
+if [ "$(source_files | wc -l | tr -d ' ')" -eq 0 ]; then
+  die "no OpenSpec artifacts found under $change_dir"
+fi
+
+hash="$(context_hash)"
+summary="$(summary_text)"
+
+script_dir="$(cd "$(dirname "${BASH_SOURCE[0]:-$0}")" && pwd -P)"
+"${BASH:-bash}" "$script_dir/onespec-state.sh" set "$change" handoff_context "$state"
+"${BASH:-bash}" "$script_dir/onespec-state.sh" set "$change" handoff_purpose "$purpose"
+"${BASH:-bash}" "$script_dir/onespec-state.sh" set "$change" handoff_summary "$summary"
+"${BASH:-bash}" "$script_dir/onespec-state.sh" set "$change" handoff_hash "$hash"
+
+echo "$state"