@tea-agent/loop-agent 0.13.0-alpha.0 → 0.13.0-beta.0

package/scripts/kb-bootstrap-init-skeleton.sh

@@ -1,239 +1,240 @@
-#!/usr/bin/env bash
-# B1 skeleton for business knowledge-graph bootstrap (no model calls).
-# Creates knowledge/bootstrap/{scope,status}.yaml, staging dirs, and graph placeholders.
-set -euo pipefail
-
-usage() {
-  cat <<'EOF'
-Usage: bash scripts/kb-bootstrap-init-skeleton.sh [--root <dir>] [--force] [--product-name <name>]
-
-Idempotent B1 bootstrap skeleton for knowledge-graph-bootstrap-dag preflight.
-
-  --root DIR         Target repository root (default: cwd)
-  --force            Overwrite scope.yaml / status.yaml if they already exist
-  --product-name N   Product name written into scope.yaml (default: basename of root)
-
-Does not call any LLM. Safe for greenfield and brownfield (default: never overwrite).
-EOF
-}
-
-ROOT="$(pwd)"
-FORCE=0
-PRODUCT_NAME=""
-
-while [[ $# -gt 0 ]]; do
-  case "$1" in
-    --root)
-      ROOT="${2:-}"
-      shift 2
-      ;;
-    --force)
-      FORCE=1
-      shift
-      ;;
-    --product-name)
-      PRODUCT_NAME="${2:-}"
-      shift 2
-      ;;
-    -h|--help)
-      usage
-      exit 0
-      ;;
-    *)
-      echo "unknown argument: $1" >&2
-      usage >&2
-      exit 2
-      ;;
-  esac
-done
-
-if [[ -z "${ROOT}" ]]; then
-  echo "--root requires a directory" >&2
-  exit 2
-fi
-
-ROOT="$(cd "${ROOT}" && pwd)"
-if [[ -z "${PRODUCT_NAME}" ]]; then
-  PRODUCT_NAME="$(basename "${ROOT}")"
-fi
-
-TS="$(date -u +"%Y-%m-%dT%H:%M:%SZ" 2>/dev/null || date -u +"%Y-%m-%dT%H:%M:%SZ")"
-BOOTSTRAP_ID="BR-$(date -u +"%Y%m%d-%H%M%S" 2>/dev/null || echo "init")"
-
-mkdir -p \
-  "${ROOT}/knowledge/bootstrap/runs" \
-  "${ROOT}/knowledge/bootstrap/staging/domains" \
-  "${ROOT}/knowledge/bootstrap/staging/services" \
-  "${ROOT}/knowledge/bootstrap/staging/modules" \
-  "${ROOT}/knowledge/bootstrap/staging/features-links.proposed" \
-  "${ROOT}/knowledge/graph" \
-  "${ROOT}/knowledge/domains" \
-  "${ROOT}/knowledge/services" \
-  "${ROOT}/knowledge/modules" \
-  "${ROOT}/knowledge/testing"
-
-write_if_missing() {
-  local path="$1"
-  local content="$2"
-  if [[ -e "${path}" && "${FORCE}" -ne 1 ]]; then
-    echo "keep existing: ${path#"${ROOT}"/}"
-    return 0
-  fi
-  mkdir -p "$(dirname "${path}")"
-  printf '%s' "${content}" > "${path}"
-  echo "wrote ${path#"${ROOT}"/}"
-}
-
-SCOPE_CONTENT=$(cat <<EOF
-# B0/B1 scope for knowledge-graph bootstrap (edit before propose).
-schema_version: 1
-product_name: ${PRODUCT_NAME}
-primary_language: zh-CN
-repo_kind: single-service
-include_paths:
-  - src/**
-  - services/**
-  - apps/**
-  - packages/**
-  - features/**
-  - docs/**
-  - README.md
-exclude_paths:
-  - node_modules/**
-  - dist/**
-  - .harness/**
-  - "**/*.min.js"
-id_namespace:
-  domain_prefix: DOM
-  service_prefix: SVC
-  api_prefix: API
-seed_domains: []
-seed_services: []
-seed_features: []
-assumptions: []
-out_of_scope: []
-human_owners:
-  architect: ""
-  qa: ""
-EOF
-)
-
-STATUS_CONTENT=$(cat <<EOF
-# Bootstrap status machine (see docs/design/knowledge-graph-ai-bootstrap.md §4)
-schema_version: 1
-bootstrap_id: ${BOOTSTRAP_ID}
-repo_root: .
-phase: B2
-updated_at: ${TS}
-scope_ref: knowledge/bootstrap/scope.yaml
-inventory_ref: knowledge/bootstrap/inventory.json
-last_run_dir: ""
-stats:
-  entities_proposed: 0
-  entities_asserted: 0
-  edges_proposed: 0
-  edges_asserted: 0
-  features_linked: 0
-blockers: []
-next_actions:
-  - "Edit knowledge/bootstrap/scope.yaml (include/exclude, seeds)"
-  - "Run knowledge-graph-bootstrap DAG or inventory step (B2+)"
-EOF
-)
-
-README_KB=$(cat <<'EOF'
-# Knowledge base
-
-Structured project knowledge (Git is authority).
-
-- `bootstrap/` — AI graph init workspace (staging only until promote)
-- `graph/` — materialize indexes (`entities-index.yaml`, `edges.yaml`)
-- `domains|services|modules/` — formal asserted entities after promote
-- `testing/` — shared testing standards (L0), Feature packs live under `features/<F>/testing/`
-
-## Bootstrap (B1+)
-
-```bash
-bash scripts/kb-bootstrap-init-skeleton.sh --root .
-# edit knowledge/bootstrap/scope.yaml
-loop-agent dag run-task <id> --profile knowledge-graph-bootstrap
-```
-
-## Query (Phase A design)
-
-```bash
-# when available:
-# bash scripts/kb-query.sh --mode by_feature --feature F-2026-004 --json
-```
-
-See `docs/design/knowledge-graph-and-query-spec.md` and `docs/design/knowledge-graph-ai-bootstrap.md`.
-EOF
-)
-
-README_BOOTSTRAP=$(cat <<'EOF'
-# Knowledge-graph bootstrap workspace
-
-- `scope.yaml` — human scope (required for preflight)
-- `status.yaml` — phase machine B0–B6
-- `inventory.json` — B2 deterministic scan output
-- `staging/**` — **only** AI write area before promote
-- `runs/**` — per-run reports
-
-AI must never set `confidence: asserted`. Promote merges new files into formal trees.
-EOF
-)
-
-README_GRAPH=$(cat <<'EOF'
-# Graph indexes
-
-Generated by materialize (B6):
-
-- `entities-index.yaml`
-- `edges.yaml`
-- `edges.manual.yaml` — human/AI-promoted edges source (optional)
-
-Do not hand-edit generated indexes without re-running materialize.
-EOF
-)
-
-STAGING_NOTES=$(cat <<'EOF'
-# Staging notes
-
-AI proposals only. Promote copies new files into `knowledge/domains|services|modules` and feature knowledge-links.
-EOF
-)
-
-EDGES_PROPOSED=$(cat <<'EOF'
-schema_version: 1
-updated_at: null
-edges: []
-EOF
-)
-
-write_if_missing "${ROOT}/knowledge/bootstrap/scope.yaml" "${SCOPE_CONTENT}"$'\n'
-write_if_missing "${ROOT}/knowledge/bootstrap/status.yaml" "${STATUS_CONTENT}"$'\n'
-write_if_missing "${ROOT}/knowledge/README.md" "${README_KB}"$'\n'
-write_if_missing "${ROOT}/knowledge/bootstrap/README.md" "${README_BOOTSTRAP}"$'\n'
-write_if_missing "${ROOT}/knowledge/graph/README.md" "${README_GRAPH}"$'\n'
-write_if_missing "${ROOT}/knowledge/bootstrap/staging/coverage-notes.md" "${STAGING_NOTES}"$'\n'
-write_if_missing "${ROOT}/knowledge/bootstrap/staging/edges.proposed.yaml" "${EDGES_PROPOSED}"$'\n'
-write_if_missing "${ROOT}/knowledge/bootstrap/staging/notes.md" "# bootstrap staging"$'\n'
-
-# Placeholders so empty trees are visible in git if desired (optional .gitkeep)
-for d in \
-  "${ROOT}/knowledge/bootstrap/runs" \
-  "${ROOT}/knowledge/bootstrap/staging/domains" \
-  "${ROOT}/knowledge/bootstrap/staging/services" \
-  "${ROOT}/knowledge/bootstrap/staging/modules" \
-  "${ROOT}/knowledge/domains" \
-  "${ROOT}/knowledge/services" \
-  "${ROOT}/knowledge/modules"
-do
-  write_if_missing "${d}/.gitkeep" ""
-done
-
-echo
-echo "B1 skeleton ready under ${ROOT}/knowledge/"
-echo "  scope:   knowledge/bootstrap/scope.yaml"
-echo "  status:  knowledge/bootstrap/status.yaml (phase: B2)"
-echo "Next: edit scope.yaml, then run knowledge-graph-bootstrap DAG."
+#!/usr/bin/env bash
+# B1 skeleton for business knowledge-graph bootstrap (no model calls).
+# Creates knowledge/bootstrap/{scope,status}.yaml, staging dirs, and graph placeholders.
+set -euo pipefail
+
+usage() {
+  cat <<'EOF'
+Usage: bash scripts/kb-bootstrap-init-skeleton.sh [--root <dir>] [--force] [--product-name <name>]
+
+Idempotent B1 bootstrap skeleton for knowledge-graph-bootstrap-dag preflight.
+
+  --root DIR         Target repository root (default: cwd)
+  --force            Overwrite scope.yaml / status.yaml if they already exist
+  --product-name N   Product name written into scope.yaml (default: basename of root)
+
+Does not call any LLM. Safe for greenfield and brownfield (default: never overwrite).
+EOF
+}
+
+ROOT="$(pwd)"
+FORCE=0
+PRODUCT_NAME=""
+
+while [[ $# -gt 0 ]]; do
+  case "$1" in
+    --root)
+      ROOT="${2:-}"
+      shift 2
+      ;;
+    --force)
+      FORCE=1
+      shift
+      ;;
+    --product-name)
+      PRODUCT_NAME="${2:-}"
+      shift 2
+      ;;
+    -h|--help)
+      usage
+      exit 0
+      ;;
+    *)
+      echo "unknown argument: $1" >&2
+      usage >&2
+      exit 2
+      ;;
+  esac
+done
+
+if [[ -z "${ROOT}" ]]; then
+  echo "--root requires a directory" >&2
+  exit 2
+fi
+
+ROOT="$(cd "${ROOT}" && pwd)"
+if [[ -z "${PRODUCT_NAME}" ]]; then
+  PRODUCT_NAME="$(basename "${ROOT}")"
+fi
+
+TS="$(date -u +"%Y-%m-%dT%H:%M:%SZ" 2>/dev/null || date -u +"%Y-%m-%dT%H:%M:%SZ")"
+BOOTSTRAP_ID="BR-$(date -u +"%Y%m%d-%H%M%S" 2>/dev/null || echo "init")"
+
+mkdir -p \
+  "${ROOT}/knowledge/bootstrap/runs" \
+  "${ROOT}/knowledge/bootstrap/staging/domains" \
+  "${ROOT}/knowledge/bootstrap/staging/services" \
+  "${ROOT}/knowledge/bootstrap/staging/modules" \
+  "${ROOT}/knowledge/bootstrap/staging/features-links.proposed" \
+  "${ROOT}/knowledge/graph" \
+  "${ROOT}/knowledge/domains" \
+  "${ROOT}/knowledge/services" \
+  "${ROOT}/knowledge/modules" \
+  "${ROOT}/knowledge/testing"
+
+write_if_missing() {
+  local path="$1"
+  local content="$2"
+  if [[ -e "${path}" && "${FORCE}" -ne 1 ]]; then
+    echo "keep existing: ${path#"${ROOT}"/}"
+    return 0
+  fi
+  mkdir -p "$(dirname "${path}")"
+  printf '%s' "${content}" > "${path}"
+  echo "wrote ${path#"${ROOT}"/}"
+}
+
+SCOPE_CONTENT=$(cat <<EOF
+# B0/B1 scope for knowledge-graph bootstrap (edit before propose).
+schema_version: 1
+product_name: ${PRODUCT_NAME}
+primary_language: zh-CN
+repo_kind: single-service
+include_paths:
+  - src/**
+  - services/**
+  - apps/**
+  - packages/**
+  - features/**
+  - docs/**
+  - README.md
+exclude_paths:
+  - node_modules/**
+  - dist/**
+  - .harness/**
+  - "**/*.min.js"
+id_namespace:
+  domain_prefix: DOM
+  service_prefix: SVC
+  api_prefix: API
+seed_domains: []
+seed_services: []
+seed_features: []
+assumptions: []
+out_of_scope: []
+human_owners:
+  architect: ""
+  qa: ""
+EOF
+)
+
+STATUS_CONTENT=$(cat <<EOF
+# Bootstrap status machine (see docs/design/knowledge-graph-ai-bootstrap.md §4)
+schema_version: 1
+bootstrap_id: ${BOOTSTRAP_ID}
+repo_root: .
+phase: B2
+updated_at: ${TS}
+scope_ref: knowledge/bootstrap/scope.yaml
+inventory_ref: knowledge/bootstrap/inventory.json
+last_run_dir: ""
+stats:
+  entities_proposed: 0
+  entities_asserted: 0
+  edges_proposed: 0
+  edges_asserted: 0
+  features_linked: 0
+blockers: []
+next_actions:
+  - "Edit knowledge/bootstrap/scope.yaml (include/exclude, seeds)"
+  - "Run knowledge-graph-bootstrap DAG or inventory step (B2+)"
+EOF
+)
+
+README_KB=$(cat <<'EOF'
+# Knowledge base
+
+Structured project knowledge (Git is authority).
+
+- `bootstrap/` — AI graph init workspace (staging only until promote)
+- `graph/` — materialize indexes (`entities-index.yaml`, `edges.yaml`)
+- `domains|services|modules/` — formal asserted entities after promote
+- `testing/` — shared testing standards (L0), Feature packs live under `features/<F>/testing/`
+
+## Bootstrap (B1+)
+
+```bash
+bash scripts/kb-bootstrap-init-skeleton.sh --root .
+# edit knowledge/bootstrap/scope.yaml
+# task.json: { "taskKind": "knowledge-graph-bootstrap", ... }
+loop-agent dag run-task <id> --execute --cwd .
+```
+
+## Query (Phase A design)
+
+```bash
+# when available:
+# bash scripts/kb-query.sh --mode by_feature --feature F-2026-004 --json
+```
+
+See `docs/design/knowledge-graph-and-query-spec.md` and `docs/design/knowledge-graph-ai-bootstrap.md`.
+EOF
+)
+
+README_BOOTSTRAP=$(cat <<'EOF'
+# Knowledge-graph bootstrap workspace
+
+- `scope.yaml` — human scope (required for preflight)
+- `status.yaml` — phase machine B0–B6
+- `inventory.json` — B2 deterministic scan output
+- `staging/**` — **only** AI write area before promote
+- `runs/**` — per-run reports
+
+AI must never set `confidence: asserted`. Promote merges new files into formal trees.
+EOF
+)
+
+README_GRAPH=$(cat <<'EOF'
+# Graph indexes
+
+Generated by materialize (B6):
+
+- `entities-index.yaml`
+- `edges.yaml`
+- `edges.manual.yaml` — human/AI-promoted edges source (optional)
+
+Do not hand-edit generated indexes without re-running materialize.
+EOF
+)
+
+STAGING_NOTES=$(cat <<'EOF'
+# Staging notes
+
+AI proposals only. Promote copies new files into `knowledge/domains|services|modules` and feature knowledge-links.
+EOF
+)
+
+EDGES_PROPOSED=$(cat <<'EOF'
+schema_version: 1
+updated_at: null
+edges: []
+EOF
+)
+
+write_if_missing "${ROOT}/knowledge/bootstrap/scope.yaml" "${SCOPE_CONTENT}"$'\n'
+write_if_missing "${ROOT}/knowledge/bootstrap/status.yaml" "${STATUS_CONTENT}"$'\n'
+write_if_missing "${ROOT}/knowledge/README.md" "${README_KB}"$'\n'
+write_if_missing "${ROOT}/knowledge/bootstrap/README.md" "${README_BOOTSTRAP}"$'\n'
+write_if_missing "${ROOT}/knowledge/graph/README.md" "${README_GRAPH}"$'\n'
+write_if_missing "${ROOT}/knowledge/bootstrap/staging/coverage-notes.md" "${STAGING_NOTES}"$'\n'
+write_if_missing "${ROOT}/knowledge/bootstrap/staging/edges.proposed.yaml" "${EDGES_PROPOSED}"$'\n'
+write_if_missing "${ROOT}/knowledge/bootstrap/staging/notes.md" "# bootstrap staging"$'\n'
+
+# Placeholders so empty trees are visible in git if desired (optional .gitkeep)
+for d in \
+  "${ROOT}/knowledge/bootstrap/runs" \
+  "${ROOT}/knowledge/bootstrap/staging/domains" \
+  "${ROOT}/knowledge/bootstrap/staging/services" \
+  "${ROOT}/knowledge/bootstrap/staging/modules" \
+  "${ROOT}/knowledge/domains" \
+  "${ROOT}/knowledge/services" \
+  "${ROOT}/knowledge/modules"
+do
+  write_if_missing "${d}/.gitkeep" ""
+done
+
+echo
+echo "B1 skeleton ready under ${ROOT}/knowledge/"
+echo "  scope:   knowledge/bootstrap/scope.yaml"
+echo "  status:  knowledge/bootstrap/status.yaml (phase: B2)"
+echo "Next: edit scope.yaml, then run knowledge-graph-bootstrap DAG."