@walwal-harness/cli 7.1.0 → 7.1.1

package/HR-Resource/ceo/SKILL.md

@@ -34,3 +34,14 @@ You are the only direct conversation channel with the Owner.
 - Before CTO/CDO/OPS allocate runnable services, agree with the Owner on a `{xx}000` base port and write it to project `.env` as `HARNESS_BASE_PORT={xx}000`. Mentioning the value in `ceo.md` is not sufficient.
 - After writing `.env`, verify with `grep '^HARNESS_BASE_PORT=' .env` before routing service work.
 - For service monitoring, collect the Owner's server mapping first: local PC, Docker, VM, AWS/cloud, host, port, health path, log path, and contact/source.
+
+## Worktree Isolation Failure — No git Repo
+
+When an Agent spawn fails with a worktree or git error (e.g., "Cannot create agent worktree: not in a git repository"), this is an **isolation constraint**, not a hiring failure. The correct response is:
+
+1. **Do not skip `harness-hiring`.** Run `harness-hiring` as normal to register the worker in `hr-roster.json`.
+2. **Do not replace hired workers with inline "You are a…" prompts.** That is impersonation, not hiring.
+3. **Spawn the hired worker as a plain `Agent()` call** (no `subagent_type`, no worktree) and set the prompt to read the worker's SKILL.md from `.harness/shared/HR-Resource/{worker-name}/SKILL.md` before executing the task.
+4. **Report the isolation constraint to the Owner** in the final summary: state that worktree isolation was unavailable and workers ran without isolation.
+
+The worktree error only affects **isolation**. `harness-hiring`, `harness-resource-manager`, and `hr-roster.json` registration are independent of git and must always run.

package/bin/init.js

@@ -165,6 +165,26 @@ const V7_REMOVED_GOTCHA_FILES = [
   'generator-backend-laravel.md',
 ];
 
+const LEGACY_V7_FILE_OWNER = {
+  'conductor.md': 'ceo.md',
+  'dispatcher.md': 'ceo.md',
+  'coo-developer.md': 'coo.md',
+  'planner.md': 'coo.md',
+  'documentationer.md': 'coo.md',
+  'generator-frontend.md': 'cto.md',
+  'generator-backend.md': 'cto.md',
+  'generator-backend-laravel.md': 'cto.md',
+  'generator-devops.md': 'cto.md',
+  'evaluator-architecture.md': 'cto.md',
+  'generator-designer.md': 'cdo.md',
+  'evaluator-visual.md': 'cdo.md',
+  'evaluator-functional.md': 'cqo.md',
+  'evaluator-code-quality.md': 'cqo.md',
+  'evaluator-security.md': 'cqo.md',
+  'meeting-manager.md': 'ops.md',
+  'service-ops.md': 'ops.md',
+};
+
 function removeLegacyV7Files(dir, files) {
   for (const file of files) {
     const target = path.join(dir, file);
@@ -174,6 +194,65 @@ function removeLegacyV7Files(dir, files) {
   }
 }
 
+function extractMarkdownEntryBlocks(md, prefix) {
+  const escapedPrefix = prefix.replace(/[.*+?^${}()|[\]\\]/g, '\\$&');
+  const re = new RegExp(
+    `^#{2,3}\\s+\\[(${escapedPrefix}-[A-Z0-9_-]+)\\][\\s\\S]*?(?=^#{2,3}\\s+\\[${escapedPrefix}-|$(?![\\s\\S]))`,
+    'gm',
+  );
+  const blocks = [];
+  let match;
+  while ((match = re.exec(md)) !== null) {
+    blocks.push({ id: match[1], body: match[0].trimEnd() });
+  }
+  return blocks;
+}
+
+function migrateLegacyRoleEntries(dir, files, kind) {
+  const prefix = kind === 'gotchas' ? 'G' : 'C';
+  const migrated = [];
+  const backupDir = path.join(HARNESS_DIR, 'archive', 'pre-v7-role-migration');
+  for (const file of files) {
+    const sourcePath = path.join(dir, file);
+    if (!fs.existsSync(sourcePath)) continue;
+
+    const content = fs.readFileSync(sourcePath, 'utf8');
+    const blocks = extractMarkdownEntryBlocks(content, prefix);
+    if (!blocks.length) continue;
+
+    const targetFile = LEGACY_V7_FILE_OWNER[file] || 'shared.md';
+    const targetPath = path.join(dir, targetFile);
+    const targetOriginal = fs.existsSync(targetPath) ? fs.readFileSync(targetPath, 'utf8') : '';
+    const targetIds = new Set(
+      kind === 'gotchas'
+        ? extractGotchaEntryIds(targetOriginal)
+        : extractConventionEntryIds(targetOriginal),
+    );
+    const appendBlocks = [];
+    for (const block of blocks) {
+      if (targetIds.has(block.id)) continue;
+      appendBlocks.push([
+        block.body,
+        '',
+        `- **Migration source**: ${kind}/${file}`,
+      ].join('\n'));
+      targetIds.add(block.id);
+    }
+    if (!appendBlocks.length) continue;
+
+    ensureDir(backupDir);
+    fs.writeFileSync(path.join(backupDir, `${kind}-${file}`), content);
+    const sep = targetOriginal.trim() ? '\n\n' : '';
+    fs.writeFileSync(targetPath, targetOriginal.replace(/\s*$/, '') + sep + appendBlocks.join('\n\n') + '\n');
+    migrated.push(`${file} → ${targetFile} (${appendBlocks.length})`);
+  }
+
+  if (migrated.length) {
+    log(`${kind} legacy role entries migrated: ${migrated.join(', ')}`);
+    log(`Legacy role migration backup: ${backupDir}`);
+  }
+}
+
 // ─────────────────────────────────────────
 // First-install migration — extract Convention/Gotcha-shaped sections from
 // existing CLAUDE.md / AGENTS.md into .harness/conventions and .harness/gotchas.
@@ -337,6 +416,9 @@ function scaffoldHarness() {
   ensureDir(path.join(HARNESS_DIR, 'memories'));
   ensureDir(path.join(HARNESS_DIR, 'shared'));
 
+  migrateLegacyRoleEntries(path.join(HARNESS_DIR, 'conventions'), V7_REMOVED_CONVENTION_FILES, 'conventions');
+  migrateLegacyRoleEntries(path.join(HARNESS_DIR, 'gotchas'), V7_REMOVED_GOTCHA_FILES, 'gotchas');
+
   removeLegacyV7Files(path.join(HARNESS_DIR, 'conventions'), V7_REMOVED_CONVENTION_FILES);
   removeLegacyV7Files(path.join(HARNESS_DIR, 'gotchas'), V7_REMOVED_GOTCHA_FILES);
 
@@ -362,7 +444,7 @@ function scaffoldHarness() {
   // a file that has such entries, or user learning history is lost.
   const gotchasSrc = path.join(PKG_ROOT, 'gotchas');
   if (fs.existsSync(gotchasSrc)) {
-    const ENTRY_PATTERN = /^### \[G-\d+\]/m;  // Gotcha entry heading
+    const ENTRY_PATTERN = /^### \[G-[A-Z0-9_-]+\]/m;  // Gotcha entry heading
     const CUSTOM_MARKER = '## Custom Gotchas'; // Legacy marker still supported
     const files = fs.readdirSync(gotchasSrc);
     for (const file of files) {
@@ -1291,11 +1373,13 @@ function runMigrate(opts = {}) {
   const dryRun = opts.dryRun || false;
   const flags = detectMigrationNeeded();
   const gotchaMissingTotal = Object.values(flags.gotchaMissingEntries || {}).reduce((n, a) => n + a.length, 0);
+  const conventionMissingTotal = Object.values(flags.conventionMissingEntries || {}).reduce((n, a) => n + a.length, 0);
   if (
     !flags.progressV3toV4 &&
     !flags.configMissingCompanyMode &&
     (!flags.memoryMissingSystemEntries || flags.memoryMissingSystemEntries.length === 0) &&
     gotchaMissingTotal === 0 &&
+    conventionMissingTotal === 0 &&
     !flags.bundleVersionStale
   ) {
     console.log('');

package/init.sh

@@ -0,0 +1,208 @@
+#!/bin/bash
+# Harness Init Script — 적응형(adaptive) 하네스 진입점 허브
+#
+# 서브커맨드:
+#   help                               — 사용법 출력
+#   check         (default · 무인자)   — 환경 확인 + scan + ref 상태 출력 (기존 동작)
+#   init          [project_root]       — 신규 프로젝트 초기화 (scan → ref placeholder → AGENTS.md → migration preview)
+#   migrate       [project_root]       — v7.1 마이그레이션 적용
+#   refresh-ref   <role> <stack>       — 기존 ref 파일 archive 백업 후 재생성 유도
+#
+# 스택별 서버 기동은 scan-result.json.tech_stack 과 .harness/ref/<role>-<stack>.md.runner 에서
+# 가져온다. NestJS/React 하드코딩은 제거되었다.
+
+set -e
+
+SUBCOMMAND="${1:-check}"
+shift || true
+
+usage() {
+  cat <<'USAGE'
+Harness Init — 적응형 하네스 진입점
+
+Usage:
+  bash init.sh help                                 — 이 메시지
+  bash init.sh check         [project_root]         — 환경 확인 + scan + ref 상태 (기본)
+  bash init.sh init          [project_root]         — scan + ref placeholder 생성 + AGENTS.md + migration dry-run
+  bash init.sh init          [project_root] --apply-migration
+                                                    — init 후 v7.1 마이그레이션까지 적용
+  bash init.sh migrate       [project_root]         — v7.1 마이그레이션 적용
+  bash init.sh migrate       [project_root] --dry-run
+                                                    — v7.1 마이그레이션 미리보기
+  bash init.sh refresh-ref   <role> <stack> [path]  — 기존 ref 파일 백업 후 재생성 안내
+
+스택 독립: 개발 서버 기동 명령은 .harness/ref/<role>-<stack>.md 의 runner.dev_command 에서 조회한다.
+USAGE
+}
+
+run_walwal_cli() {
+  local project_root="$1"
+  shift || true
+  local script_dir
+  script_dir="$(cd "$(dirname "$0")" && pwd)"
+  local cli_path="${script_dir}/bin/init.js"
+
+  if [ -f "$cli_path" ]; then
+    (cd "$project_root" && node "$cli_path" "$@")
+  else
+    (cd "$project_root" && npx walwal-harness "$@")
+  fi
+}
+
+run_migrate() {
+  local project_root="."
+  local mode=""
+
+  if [ "${1:-}" = "--dry-run" ]; then
+    mode="--dry-run"
+  else
+    project_root="${1:-.}"
+    mode="${2:-}"
+  fi
+
+  echo "=== Harness Migration: ${project_root} ==="
+  if [ "$mode" = "--dry-run" ]; then
+    run_walwal_cli "$project_root" migrate --dry-run
+  else
+    run_walwal_cli "$project_root" migrate
+  fi
+}
+
+run_check() {
+  local project_root="${1:-.}"
+  echo "=== Harness Environment Check ==="
+  echo "Working Directory: $(pwd)"
+  echo "Date: $(date)"
+  echo ""
+
+  # Git 상태
+  echo "--- Git Status ---"
+  if [ -d "${project_root}/.git" ]; then
+    git -C "$project_root" log --oneline -5 2>/dev/null || echo "No commits yet"
+    echo ""
+    git -C "$project_root" status --short
+  else
+    echo "Not a git repository — run: git init"
+  fi
+  echo ""
+
+  # Harness 상태
+  echo "--- Harness Status ---"
+  if [ -f "${project_root}/.harness/progress.json" ]; then
+    if [ -f "${project_root}/scripts/lib/harness-render-progress.sh" ]; then
+      (cd "$project_root" && source scripts/lib/harness-render-progress.sh && render_progress "." 2>/dev/null) || cat "${project_root}/.harness/progress.json"
+    else
+      cat "${project_root}/.harness/progress.json"
+    fi
+  else
+    echo "progress.json not found — run: bash init.sh init"
+  fi
+  echo ""
+
+  # scan 상태
+  echo "--- Scan Result ---"
+  if [ -f "${project_root}/.harness/actions/scan-result.json" ]; then
+    jq '{tech_stack, tech_stack_confidence, recommendation}' "${project_root}/.harness/actions/scan-result.json"
+  else
+    echo "scan-result.json not found — run: bash scripts/scan-project.sh ${project_root}"
+  fi
+  echo ""
+
+  # ref 상태
+  echo "--- Ref Docs ---"
+  if [ -d "${project_root}/.harness/ref" ]; then
+    ls -1 "${project_root}/.harness/ref/" 2>/dev/null | grep -v '^\.generated' | sed 's/^/  /' || echo "  (none)"
+  else
+    echo "  .harness/ref/ not present — run: bash init.sh init"
+  fi
+  echo ""
+
+  echo "=== Harness Ready ==="
+}
+
+run_init() {
+  local project_root="."
+  local migration_mode="--dry-run"
+  if [ "${1:-}" = "--apply-migration" ]; then
+    migration_mode="--apply-migration"
+  else
+    project_root="${1:-.}"
+    if [ "${2:-}" = "--apply-migration" ]; then
+      migration_mode="--apply-migration"
+    fi
+  fi
+  echo "=== Harness Init: ${project_root} ==="
+
+  # 1. scan
+  echo "[1/4] scan-project.sh"
+  bash "$(dirname "$0")/scripts/scan-project.sh" "$project_root"
+  echo ""
+
+  # 2. ref placeholder 생성 (감지된 스택 전체)
+  echo "[2/4] init-ref-docs.sh (placeholder)"
+  bash "$(dirname "$0")/scripts/init-ref-docs.sh" --yes --placeholder "$project_root"
+  echo ""
+
+  # 3. AGENTS.md 동적 생성
+  if [ -f "$(dirname "$0")/scripts/init-agents-md.sh" ]; then
+    echo "[3/4] init-agents-md.sh"
+    bash "$(dirname "$0")/scripts/init-agents-md.sh" "$project_root"
+  else
+    echo "[3/4] init-agents-md.sh — skip (not found)"
+  fi
+  echo ""
+
+  # 4. v7.1 migration preview/apply
+  if [ "$migration_mode" = "--apply-migration" ]; then
+    echo "[4/4] walwal-harness migrate"
+    run_walwal_cli "$project_root" migrate
+  else
+    echo "[4/4] walwal-harness migrate --dry-run"
+    run_walwal_cli "$project_root" migrate --dry-run
+  fi
+  echo ""
+
+  echo "=== Init Complete ==="
+  echo "다음 단계:"
+  echo "  1. 각 .harness/ref/<role>-<stack>.md 를 실제 컨텐츠로 채우려면:"
+  echo "     bash init.sh refresh-ref <role> <stack> $project_root"
+  echo "  2. 그 결과 프롬프트를 Claude 세션에 붙여 WebSearch + WebFetch 로 ref 작성"
+  if [ "$migration_mode" != "--apply-migration" ]; then
+    echo "  3. 마이그레이션 미리보기가 적절하면 적용:"
+    echo "     bash init.sh migrate $project_root"
+  fi
+}
+
+run_refresh_ref() {
+  local role="$1" stack="$2" project_root="${3:-.}"
+  if [ -z "$role" ] || [ -z "$stack" ]; then
+    echo "ERROR: bash init.sh refresh-ref <role> <stack> [project_root]" >&2
+    exit 1
+  fi
+
+  local ref_path="${project_root}/.harness/ref/${role}-${stack}.md"
+  local archive_dir="${project_root}/.harness/archive"
+  mkdir -p "$archive_dir"
+
+  if [ -f "$ref_path" ]; then
+    local backup="${archive_dir}/ref-${role}-${stack}-$(date +%Y%m%d%H%M%S).md"
+    mv "$ref_path" "$backup"
+    echo "archive: $backup"
+  fi
+
+  echo ""
+  bash "$(dirname "$0")/scripts/init-ref-docs.sh" --claude-prompt --stack "$stack" --role "$role" "$project_root"
+}
+
+case "$SUBCOMMAND" in
+  help|-h|--help)      usage ;;
+  check)               run_check "$@" ;;
+  init)                run_init "$@" ;;
+  migrate)             run_migrate "$@" ;;
+  refresh-ref)         run_refresh_ref "$@" ;;
+  *)
+    echo "ERROR: unknown subcommand '$SUBCOMMAND'" >&2
+    usage
+    exit 1
+    ;;
+esac

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@walwal-harness/cli",
-  "version": "7.1.0",
+  "version": "7.1.1",
   "description": "Company-style AI agent harness for Claude and Codex. Installs commands, CXX agents, skills, HR-Resource hiring pool, and project-local .harness runtime state.",
   "bin": {
     "walwal-harness": "bin/init.js"
@@ -48,6 +48,7 @@
     "assets/",
     "gotchas/",
     "conventions/",
+    "init.sh",
     "CHANGELOG.md"
   ]
 }