Nicolas Cantu
61cec6f430
**Motivations:** - Align master with current codebase (token from projects/<id>/.secrets/<env>/ia_token) - Id resolution by mail To or by API token; no slug **Root causes:** - Token moved from conf.json to .secrets/<env>/ia_token; env from directory name **Correctifs:** - Server and scripts resolve project+env by scanning all projects and envs **Evolutions:** - tickets-fetch-inbox routes by To address; notary-ai agents and API doc updated **Pages affectées:** - ai_working_help/server.js, docs, project_config.py, lib/project_config.sh - projects/README.md, lecoffreio/docs/API.md, gitea-issues/tickets-fetch-inbox.py
101 lines
3.0 KiB
Bash
Executable File
101 lines
3.0 KiB
Bash
Executable File
#!/usr/bin/env bash
|
|
#
|
|
# Migrate all docs/*.md (repo root) to Gitea wiki as pages.
|
|
# Mapping: docs/FILE.md → page "File" (stem with _ → -, first letter upper per segment).
|
|
# Requires GITEA_TOKEN or .secrets/gitea-issues/token.
|
|
# Usage: ./wiki-migrate-docs.sh [--dry-run] [file.md ...]
|
|
# --dry-run: print mapping and skip API calls.
|
|
# If file(s) given: migrate only those; else migrate all docs/*.md.
|
|
#
|
|
set -euo pipefail
|
|
|
|
GITEA_ISSUES_DIR="${GITEA_ISSUES_DIR:-$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)}"
|
|
REPO_ROOT="${GITEA_ISSUES_DIR}/.."
|
|
DOCS_DIR="${REPO_ROOT}/docs"
|
|
# shellcheck source=lib.sh
|
|
source "${GITEA_ISSUES_DIR}/lib.sh"
|
|
|
|
REPO_PATH="/repos/${GITEA_REPO_OWNER}/${GITEA_REPO_NAME}"
|
|
GITEA_WIKI_REF="${GITEA_WIKI_REF:-master}"
|
|
WIKI_PAGE="${REPO_PATH}/wiki/page"
|
|
WIKI_NEW="${REPO_PATH}/wiki/new"
|
|
|
|
# docs/FILE.md → page name for wiki (stem: _ → -, title-case: First-Letter-Of-Each-Segment)
|
|
file_to_page_name() {
|
|
local base="$1"
|
|
local stem="${base%.md}"
|
|
echo "$stem" | tr '_' '-' | awk -F- '{
|
|
for(i=1;i<=NF;i++) {
|
|
s = $i; l = length(s)
|
|
if (l > 0) $i = toupper(substr(s,1,1)) tolower(substr(s,2))
|
|
}
|
|
}1' OFS='-'
|
|
}
|
|
|
|
dry_run=false
|
|
files=()
|
|
while [[ $# -gt 0 ]]; do
|
|
case "$1" in
|
|
--dry-run) dry_run=true; shift ;;
|
|
*.md) files+=("$1"); shift ;;
|
|
*) log_err "Unknown option or not .md: $1"; exit 1 ;;
|
|
esac
|
|
done
|
|
|
|
if [[ ${#files[@]} -eq 0 ]]; then
|
|
while IFS= read -r -d '' f; do
|
|
files+=("$f")
|
|
done < <(find "$DOCS_DIR" -maxdepth 1 -name '*.md' -print0 | sort -z)
|
|
else
|
|
# Resolve args to full paths under DOCS_DIR
|
|
for i in "${!files[@]}"; do
|
|
u="${files[$i]}"
|
|
if [[ "$u" != */* ]] && [[ -f "${DOCS_DIR}/${u}" ]]; then
|
|
files[$i]="${DOCS_DIR}/${u}"
|
|
fi
|
|
done
|
|
fi
|
|
|
|
if [[ ${#files[@]} -eq 0 ]]; then
|
|
log_err "No .md files found in ${DOCS_DIR}"
|
|
exit 1
|
|
fi
|
|
|
|
if [[ "$dry_run" == true ]]; then
|
|
log_info "Dry run: would migrate ${#files[@]} file(s)"
|
|
for f in "${files[@]}"; do
|
|
base="$(basename "$f")"
|
|
page="$(file_to_page_name "$base")"
|
|
echo " $f → $page"
|
|
done
|
|
exit 0
|
|
fi
|
|
|
|
load_gitea_token || exit 1
|
|
require_jq || exit 1
|
|
|
|
for f in "${files[@]}"; do
|
|
base="$(basename "$f")"
|
|
page="$(file_to_page_name "$base")"
|
|
if [[ ! -f "$f" ]]; then
|
|
log_err "Skip (not a file): $f"
|
|
continue
|
|
fi
|
|
content="$(cat "$f")"
|
|
content_b64="$(echo -n "$content" | base64 -w 0)"
|
|
body="$(jq -n --arg title "$page" --arg content "$content_b64" --arg msg "Migrate from docs/$base" \
|
|
'{ title: $title, content_base64: $content, message: $msg }')"
|
|
# Check if page exists (GET); if 200 use PATCH else POST
|
|
resp="$(gitea_api_get "${REPO_PATH}/wiki/page/${page}?ref=${GITEA_WIKI_REF}")"
|
|
if echo "$resp" | jq -e .title &>/dev/null; then
|
|
log_info "Update: $base → $page"
|
|
patch_body="$(jq -n --arg content "$content_b64" --arg msg "Update from docs/$base" '{ content_base64: $content, message: $msg }')"
|
|
gitea_api_patch "${WIKI_PAGE}/${page}?ref=${GITEA_WIKI_REF}" "$patch_body" >/dev/null || true
|
|
else
|
|
log_info "Create: $base → $page"
|
|
gitea_api_post "${WIKI_NEW}" "$body" >/dev/null || true
|
|
fi
|
|
done
|
|
|
|
log_info "Migration done: ${#files[@]} file(s)."
|