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

package/scripts/check-product-line-docs.sh

@@ -1,29 +1,29 @@
-#!/usr/bin/env bash
-set -euo pipefail
-
-ROOT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")/.." && pwd)"
-cd "${ROOT_DIR}"
-
-feature_dirs=()
-for root in features product/features dogfood/features; do
-  [[ -d "${root}" ]] || continue
-  while IFS= read -r feature_dir; do
-    if [[ ! -f "${feature_dir}/acceptance.yaml" ]]; then
-      echo "product-line docs check failed: incomplete feature packet missing acceptance.yaml: ${feature_dir}" >&2
-      exit 1
-    fi
-    feature_dirs+=("${feature_dir}")
-  done < <(find "${root}" -mindepth 1 -maxdepth 1 -type d | sort)
-done
-
-if [[ ${#feature_dirs[@]} -eq 0 ]]; then
-  echo "product-line docs check skipped: no feature packets found"
-  exit 0
-fi
-
-for feature_dir in "${feature_dirs[@]}"; do
-  echo "==> validate product-line feature: ${feature_dir}"
-  node --import tsx/esm src/worker/cli.ts task validate-feature "${feature_dir}"
-done
-
-echo "product-line docs checks passed: ${#feature_dirs[@]} feature packet(s)"
+#!/usr/bin/env bash
+set -euo pipefail
+
+ROOT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")/.." && pwd)"
+cd "${ROOT_DIR}"
+
+feature_dirs=()
+for root in features product/features dogfood/features; do
+  [[ -d "${root}" ]] || continue
+  while IFS= read -r feature_dir; do
+    if [[ ! -f "${feature_dir}/acceptance.yaml" ]]; then
+      echo "product-line docs check failed: incomplete feature packet missing acceptance.yaml: ${feature_dir}" >&2
+      exit 1
+    fi
+    feature_dirs+=("${feature_dir}")
+  done < <(find "${root}" -mindepth 1 -maxdepth 1 -type d | sort)
+done
+
+if [[ ${#feature_dirs[@]} -eq 0 ]]; then
+  echo "product-line docs check skipped: no feature packets found"
+  exit 0
+fi
+
+for feature_dir in "${feature_dirs[@]}"; do
+  echo "==> validate product-line feature: ${feature_dir}"
+  node --import tsx/esm src/worker/cli.ts task validate-feature "${feature_dir}"
+done
+
+echo "product-line docs checks passed: ${#feature_dirs[@]} feature packet(s)"

package/scripts/check-task-pool-root.sh

@@ -1,32 +1,32 @@
-#!/usr/bin/env bash
-set -euo pipefail
-
-ROOT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")/.." && pwd)"
-cd "${ROOT_DIR}"
-
-scan_paths=(
-  src
-  test
-  scripts
-  .github
-  README.md
-  AGENTS.md
-  harness.json
-  docs/architecture
-  docs/README.md
-  docs/loop-agent-harness.md
-  docs/init-surface.manifest.json
-  skills
-  website/docs
-)
-
-matches="$(rg -n --path-separator / '[.]task-pool' "${scan_paths[@]}" 2>/dev/null || true)"
-matches="$(printf '%s\n' "${matches}" | rg -v '^(README\.md|AGENTS\.md):.*gitignore|^src/commands/init\.ts:.*("[.]task-pool/"|legacy [.]task-pool residue)|^test/init-command\.test\.ts:.*toContain\("[.]task-pool/"\)|^website/docs/reference/cli\.md:.*旧顶层.*[.]task-pool' || true)"
-
-if [[ -n "${matches}" ]]; then
-  echo "Task Pool root 检查失败：活跃源码、测试、脚本或用户文档仍引用已废弃的顶层 runtime path：" >&2
-  printf '%s\n' "${matches}" >&2
-  exit 1
-fi
-
-echo "Task Pool root 检查通过：活跃 surface 只使用 .harness/task-pool"
+#!/usr/bin/env bash
+set -euo pipefail
+
+ROOT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")/.." && pwd)"
+cd "${ROOT_DIR}"
+
+scan_paths=(
+  src
+  test
+  scripts
+  .github
+  README.md
+  AGENTS.md
+  harness.json
+  docs/architecture
+  docs/README.md
+  docs/loop-agent-harness.md
+  docs/init-surface.manifest.json
+  skills
+  website/docs
+)
+
+matches="$(rg -n --path-separator / '[.]task-pool' "${scan_paths[@]}" 2>/dev/null || true)"
+matches="$(printf '%s\n' "${matches}" | rg -v '^(README\.md|AGENTS\.md):.*gitignore|^src/commands/init\.ts:.*("[.]task-pool/"|legacy [.]task-pool residue)|^test/init-command\.test\.ts:.*toContain\("[.]task-pool/"\)|^website/docs/reference/cli\.md:.*旧顶层.*[.]task-pool' || true)"
+
+if [[ -n "${matches}" ]]; then
+  echo "Task Pool root 检查失败：活跃源码、测试、脚本或用户文档仍引用已废弃的顶层 runtime path：" >&2
+  printf '%s\n' "${matches}" >&2
+  exit 1
+fi
+
+echo "Task Pool root 检查通过：活跃 surface 只使用 .harness/task-pool"

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

@@ -0,0 +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
+# 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."