llm-wb 0.1.0-beta.0

package/scripts/uninstall.sh

@@ -0,0 +1,199 @@
+#!/usr/bin/env bash
+set -euo pipefail
+
+# agentic-artifact:
+#   schema: agentic-artifact/v2
+#   id: chat.script.uninstall
+#   version: 1
+#   status: active
+#   layer: 00.chat
+#   domain: install
+#   disciplines:
+#   - agentic
+#   kind: script
+#   purpose: Uninstall manifest-owned llm-workbench files from a target Git repository.
+#   portability:
+#     class: required
+#     targets:
+#     - llm-workbench
+#   used_by:
+#   - id: llm-workbench.docs.install
+#   effects:
+#   - writes-files
+
+usage() {
+  cat <<'EOF'
+Usage:
+  scripts/uninstall.sh [--dry-run|--apply] <target-git-repo>
+
+Removes llm-workbench-managed files, package scripts, and instruction blocks
+recorded in .llm-workbench/install-manifest.tsv.
+EOF
+}
+
+MODE=""
+TARGET_REPO=""
+
+while [ $# -gt 0 ]; do
+  case "$1" in
+    --dry-run)
+      [ -z "$MODE" ] || { echo "ERROR: choose one mode." >&2; exit 2; }
+      MODE="dry-run"
+      shift
+      ;;
+    --apply)
+      [ -z "$MODE" ] || { echo "ERROR: choose one mode." >&2; exit 2; }
+      MODE="apply"
+      shift
+      ;;
+    -h|--help)
+      usage
+      exit 0
+      ;;
+    -*)
+      echo "ERROR: unknown argument: $1" >&2
+      usage >&2
+      exit 2
+      ;;
+    *)
+      [ -z "$TARGET_REPO" ] || { echo "ERROR: target repo specified twice." >&2; exit 2; }
+      TARGET_REPO="$1"
+      shift
+      ;;
+  esac
+done
+
+MODE="${MODE:-dry-run}"
+
+if [ -z "$TARGET_REPO" ]; then
+  usage >&2
+  exit 2
+fi
+
+if [ ! -d "$TARGET_REPO/.git" ]; then
+  echo "ERROR: target is not a Git repo: $TARGET_REPO" >&2
+  exit 1
+fi
+
+SOURCE_REPO="$(cd "$(dirname "$0")/.." && pwd)"
+MANIFEST_PATH="$TARGET_REPO/.llm-workbench/install-manifest.tsv"
+
+if [ ! -f "$MANIFEST_PATH" ]; then
+  echo "ERROR: install manifest not found: ${MANIFEST_PATH#$TARGET_REPO/}" >&2
+  exit 1
+fi
+
+remove_managed_block() {
+  local relative_path="$1"
+  local target="$TARGET_REPO/$relative_path"
+  local tmp
+
+  [ -f "$target" ] || return 0
+  tmp="$(mktemp)"
+
+  awk '
+    /<!-- llm-workbench:start -->/ {
+      in_block = 1
+      next
+    }
+    /<!-- llm-workbench:end -->/ {
+      in_block = 0
+      next
+    }
+    in_block == 1 {
+      next
+    }
+    {
+      print
+    }
+  ' "$target" > "$tmp"
+
+  mv "$tmp" "$target"
+}
+
+remove_package_script() {
+  local script_name="$1"
+  local target_package="$TARGET_REPO/package.json"
+  local source_package="$SOURCE_REPO/package.json"
+
+  [ -f "$target_package" ] || return 0
+
+  node - "$target_package" "$source_package" "$script_name" <<'NODE'
+const fs = require('fs');
+const targetPath = process.argv[2];
+const sourcePath = process.argv[3];
+const scriptName = process.argv[4];
+
+const target = JSON.parse(fs.readFileSync(targetPath, 'utf8'));
+const source = JSON.parse(fs.readFileSync(sourcePath, 'utf8'));
+
+if (!target.scripts || !Object.prototype.hasOwnProperty.call(target.scripts, scriptName)) {
+  process.exit(0);
+}
+
+const expected = source.scripts && source.scripts[scriptName];
+if (expected !== undefined && target.scripts[scriptName] !== expected) {
+  process.exit(0);
+}
+
+delete target.scripts[scriptName];
+if (Object.keys(target.scripts).length === 0) {
+  delete target.scripts;
+}
+
+fs.writeFileSync(targetPath, `${JSON.stringify(target, null, 2)}\n`);
+NODE
+}
+
+cleanup_empty_dirs() {
+  for path in \
+    "$TARGET_REPO/scripts" \
+    "$TARGET_REPO/.agentic" \
+    "$TARGET_REPO/.github" \
+    "$TARGET_REPO/.cursor" \
+    "$TARGET_REPO/.llm-workbench"; do
+    [ -d "$path" ] || continue
+    find "$path" -depth -type d -empty -delete
+  done
+}
+
+echo "llm-workbench uninstall ${MODE}"
+echo
+echo "Target repo: $TARGET_REPO"
+echo "Manifest: ${MANIFEST_PATH#$TARGET_REPO/}"
+echo
+
+while IFS=$'\t' read -r kind value; do
+  [ -n "${kind:-}" ] || continue
+  case "$kind" in
+    create)
+      echo "REMOVE_CREATED $value"
+      if [ "$MODE" = "apply" ]; then
+        rm -f "$TARGET_REPO/$value"
+      fi
+      ;;
+    patch-block)
+      echo "REMOVE_BLOCK $value"
+      if [ "$MODE" = "apply" ]; then
+        remove_managed_block "$value"
+      fi
+      ;;
+    package-script)
+      echo "REMOVE_PACKAGE_SCRIPT $value"
+      if [ "$MODE" = "apply" ]; then
+        remove_package_script "$value"
+      fi
+      ;;
+    *)
+      echo "ERROR: unknown manifest entry kind: $kind" >&2
+      exit 1
+      ;;
+  esac
+done < "$MANIFEST_PATH"
+
+if [ "$MODE" = "apply" ]; then
+  rm -f "$MANIFEST_PATH"
+  cleanup_empty_dirs
+  echo
+  echo "Uninstall completed."
+fi

package/tests/smoke-test-install.sh

@@ -0,0 +1,70 @@
+#!/usr/bin/env bash
+set -euo pipefail
+
+WORKBENCH_REPO="$(cd "$(dirname "$0")/.." && pwd)"
+TMP_ROOT="$(mktemp -d "${TMPDIR:-/tmp}/llm-workbench-install.XXXXXX")"
+TARGET_REPO="$TMP_ROOT/target"
+
+cleanup() {
+  rm -rf "$TMP_ROOT"
+}
+trap cleanup EXIT
+
+mkdir -p "$TARGET_REPO"
+git -C "$TARGET_REPO" init -q
+git -C "$TARGET_REPO" config user.name "llm-workbench smoke test"
+git -C "$TARGET_REPO" config user.email "llm-workbench-smoke@example.invalid"
+
+bash "$WORKBENCH_REPO/scripts/install.sh" "$TARGET_REPO"
+
+test -f "$TARGET_REPO/AGENTS.md"
+test -f "$TARGET_REPO/bin/llm-workbench.js"
+test -d "$TARGET_REPO/.agentic/00.chat"
+test -d "$TARGET_REPO/scripts/00.chat"
+test -d "$TARGET_REPO/scripts/01.harness"
+test ! -e "$TARGET_REPO/docs/00.chat/public-chat-workbench-adrs.md"
+test ! -e "$TARGET_REPO/docs/harness/architecture/adrs"
+
+for required_path in \
+  scripts/01.harness/run-governed-script.sh \
+  scripts/01.harness/check-deterministic-process-drift.sh \
+  scripts/01.harness/check-governed-script-command-drift.sh \
+  scripts/01.harness/artifact-metadata/check-headers/script.sh \
+  scripts/01.harness/artifact-metadata/check-headers/smoke-test.sh; do
+  test -f "$TARGET_REPO/$required_path"
+done
+
+for source_only_path in \
+  scripts/01.harness/artifact-metadata/backfill-v2-headers/script.sh \
+  scripts/01.harness/artifact-metadata/generate-index/script.sh \
+  scripts/01.harness/check-artifact-metadata-headers.sh \
+  scripts/01.harness/check-artifact-path-migration.sh \
+  scripts/01.harness/check-rule-test-taxonomy.sh \
+  scripts/01.harness/plan-artifact-path-migration.sh \
+  scripts/01.harness/smoke-test-artifact-path-migration.sh; do
+  test ! -e "$TARGET_REPO/$source_only_path"
+done
+
+if grep -RIEq '\.agentic/01\.harness|scripts/02\.rag-rulebook|\.agentic/02\.rag-rulebook' \
+  "$TARGET_REPO/scripts/01.harness"; then
+  echo "ERROR: installed target harness scripts reference source-only harness/rulebook surfaces." >&2
+  exit 1
+fi
+
+npm --prefix "$TARGET_REPO" run --silent chat:list >/dev/null
+node "$TARGET_REPO/bin/llm-workbench.js" --help >/dev/null
+
+git -C "$TARGET_REPO" add -A
+git -C "$TARGET_REPO" commit -q -m "Install llm-workbench harness"
+
+(
+  cd "$TARGET_REPO"
+  AGENTIC_CHAT_WORKTREE_ROOT="$TMP_ROOT/worktrees" \
+  CHAT_COPY_PROMPT=skip CHAT_CLEANUP_EMPTY_BRANCHES=skip \
+  CHAT_OPEN_WORKTREE_WINDOW=skip \
+    npm run --silent chat:new -- "smoke test first chat startup" >/dev/null
+)
+
+find "$TMP_ROOT/worktrees" -path '*/commitLogs/*/README.md' -type f | grep -q .
+
+echo "Install smoke test passed."