maskweaver 0.8.3 → 0.8.4

package/README.ko.md

@@ -24,9 +24,10 @@
 - **전문가 페르소나 (Masks)**: 전설적인 개발자들의 철학을 담은 표준 YAML 프로필.
 - **스마트 위임**: OpenCode에 최적화된 멀티 에이전트 워크플로우.
 - **프로젝트 메모리**: 코드베이스 전체에 대한 하이브리드 의미론적 검색.
-- **🆕 Weave 워크플로우**: AI 자체 검증이 포함된 Phase 기반 개발.
-
----
+- **🆕 Weave 워크플로우**: AI 자체 검증이 포함된 Phase 기반 개발.
+- **🔗 GDC 통합**: Graph-Driven Codebase 지원으로 리서치 품질 향상 및 설계 시점 검증 게이트 추가.
+
+---
 
 ## 왜 Maskweaver인가요?
 
@@ -227,9 +228,43 @@ Weave는 Maskweaver의 핵심 워크플로우입니다. 작업을 테스트 가
 | 5️⃣ E2E Tests | 테스트 | **Playwright** |
 | 6️⃣ Screenshot | 시각 | Playwright / 브라우저 캡처 |
 | 7️⃣ API Check | API | `fetch` 헬스 체크 |
-| 8️⃣ A11y | 접근성 | `axe-core` |
-
-#### 마스크 자동 선택
+| 8️⃣ A11y | 접근성 | `axe-core` |
+| 0️⃣ GDC Check | 설계 | `gdc check --machine` |
+
+#### GDC 통합 (Graph-Driven Codebase)
+
+Weave는 [GDC](https://github.com/ulgerang/gdc)(Graph-Driven Codebase)와 통합되어 리서치 품질을 향상시키고 설계 시점 검증 게이트를 추가합니다:
+
+**리서치 강화:**
+- `.gdc` 워크스페이스 자동 감지
+- GDC `stats`, `graph`, `check` 결과를 `tasks/research.md`에 포함
+- 그래프 엣지 기반 의존성 영향 범위(Blast Radius) 분석
+- 기능 키워드와 매칭된 재사용 후보 노드
+- 새 보고서 섹션: `GDC Node Coverage`, `Dependency Blast Radius`, `Existing Spec vs Implementation Drift`, `Candidate Reuse Nodes`
+
+**Pre-Verify 게이트:**
+GDC가 감지되면 `weave verify`와 `weave flow`가 자동으로 실행:
+1. `gdc sync --machine` - 스펙과 구현 동기화
+2. `gdc check --machine` - 스펙/구현 일치성 검증
+
+GDC check의 블로킹 에러는 검증을 중단시킵니다(`strictVerify` 모드로 설정 가능).
+
+**설정** (`maskweaver.config.json`):
+```json
+{
+  "gdc": {
+    "enabled": "auto",
+    "strictVerify": false,
+    "autoSyncOnPrepare": true
+  }
+}
+```
+
+- `enabled`: `true` | `false` | `"auto"` (기본값: `.gdc` 디렉터리 자동 감지)
+- `strictVerify`: `true`면 GDC check 실패 시 검증 차단; `false`면 경고 후 계속 진행
+- `autoSyncOnPrepare`: `weave prepare` 시 `gdc sync` 실행
+
+#### 마스크 자동 선택
 
 AI가 각 작업에 가장 적합한 전문가를 자동으로 선택합니다:
 
@@ -333,14 +368,15 @@ import { MaskLoader } from 'maskweaver/core';
 import { WeaveOrchestrator, GlobalKnowledge } from 'maskweaver/weave';
 ```
 
-**모듈:**
-- `maskweaver/core` - 가면 로딩, 검증 (YAML/JSON)
-- `maskweaver/memory` - 임베딩 + 벡터 검색 (5개 프로바이더)
-- `maskweaver/context` - 기능 기반 작업 추적
-- `maskweaver/verify` - 교차 가면 코드 리뷰
-- `maskweaver/retrospect` - 세션 효과 분석
-- `maskweaver/weave` - Phase 기반 개발 워크플로우
-- `maskweaver/plugin` - OpenCode 플러그인 엔트리 포인트
+**모듈:**
+- `maskweaver/core` - 가면 로딩, 검증 (YAML/JSON)
+- `maskweaver/memory` - 임베딩 + 벡터 검색 (5개 프로바이더)
+- `maskweaver/context` - 기능 기반 작업 추적
+- `maskweaver/verify` - 교차 가면 코드 리뷰
+- `maskweaver/retrospect` - 세션 효과 분석
+- `maskweaver/weave` - Phase 기반 개발 워크플로우
+- `maskweaver/gdc` - GDC(Graph-Driven Codebase) 통합 유틸리티
+- `maskweaver/plugin` - OpenCode 플러그인 엔트리 포인트
 
 ---
 

package/README.md

@@ -24,9 +24,10 @@ While it can be used as a standalone library, it works great with OpenCode to ad
 - **Expert Personas (Masks)**: Standardized YAML profiles for legendary developers.
 - **Smart Delegation**: Multi-agent workflows optimized for OpenCode.
 - **Project Memory**: Hybrid semantic search for your entire codebase.
-- **🆕 Weave Workflow**: Phase-driven development with AI self-verification.
-
----
+- **🆕 Weave Workflow**: Phase-driven development with AI self-verification.
+- **🔗 GDC Integration**: Graph-Driven Codebase support for enhanced research and design-time verification gates.
+
+---
 
 ## Why Maskweaver?
 
@@ -246,9 +247,43 @@ Before handing off to you, AI runs these verification layers:
 | 5️⃣ E2E Tests | Test | **Playwright** |
 | 6️⃣ Screenshot | Visual | Playwright / browser capture |
 | 7️⃣ API Check | API | `fetch` health checks |
-| 8️⃣ A11y | Accessibility | `axe-core` |
-
-#### Autonomous Mask Selection
+| 8️⃣ A11y | Accessibility | `axe-core` |
+| 0️⃣ GDC Check | Design | `gdc check --machine` |
+
+#### GDC Integration (Graph-Driven Codebase)
+
+Weave integrates with [GDC](https://github.com/ulgerang/gdc) (Graph-Driven Codebase) to enhance research quality and add design-time verification gates:
+
+**Research Enhancement:**
+- Automatic `.gdc` workspace detection
+- GDC `stats`, `graph`, and `check` results embedded in `tasks/research.md`
+- Dependency blast radius analysis from graph edges
+- Candidate reuse nodes matched against feature keywords
+- New report sections: `GDC Node Coverage`, `Dependency Blast Radius`, `Existing Spec vs Implementation Drift`, `Candidate Reuse Nodes`
+
+**Pre-Verify Gate:**
+When GDC is detected, `weave verify` and `weave flow` automatically run:
+1. `gdc sync --machine` - Sync specs with implementation
+2. `gdc check --machine` - Validate spec/implementation alignment
+
+Blocking errors from GDC check will halt verification (configurable via `strictVerify` mode).
+
+**Configuration** (`maskweaver.config.json`):
+```json
+{
+  "gdc": {
+    "enabled": "auto",
+    "strictVerify": false,
+    "autoSyncOnPrepare": true
+  }
+}
+```
+
+- `enabled`: `true` | `false` | `"auto"` (default: auto-detect from `.gdc` directory)
+- `strictVerify`: If `true`, GDC check failures block verification; if `false`, continues with warning
+- `autoSyncOnPrepare`: Run `gdc sync` during `weave prepare`
+
+#### Autonomous Mask Selection
 
 The AI automatically picks the best expert for each task:
 
@@ -352,14 +387,15 @@ import { MaskLoader } from 'maskweaver/core';
 import { WeaveOrchestrator, GlobalKnowledge } from 'maskweaver/weave';
 ```
 
-**Modules:**
-- `maskweaver/core` - Mask loading, validation (YAML/JSON)
-- `maskweaver/memory` - Embeddings + vector search (5 providers)
-- `maskweaver/context` - Feature-based work tracking
-- `maskweaver/verify` - Cross-mask code review
-- `maskweaver/retrospect` - Session effectiveness analysis
-- `maskweaver/weave` - Phase-driven development workflow
-- `maskweaver/plugin` - OpenCode plugin entry point
+**Modules:**
+- `maskweaver/core` - Mask loading, validation (YAML/JSON)
+- `maskweaver/memory` - Embeddings + vector search (5 providers)
+- `maskweaver/context` - Feature-based work tracking
+- `maskweaver/verify` - Cross-mask code review
+- `maskweaver/retrospect` - Session effectiveness analysis
+- `maskweaver/weave` - Phase-driven development workflow
+- `maskweaver/gdc` - GDC (Graph-Driven Codebase) integration utilities
+- `maskweaver/plugin` - OpenCode plugin entry point
 
 ---
 

package/dist/plugin/tools/weave.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"weave.d.ts","sourceRoot":"","sources":["../../../src/plugin/tools/weave.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AA2BxB,wBAAgB,eAAe;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;oBAsFb;QACF,OAAO,EAAE,UAAU,GAAG,MAAM,GAAG,QAAQ,GAAG,SAAS,GAAG,aAAa,GAAG,cAAc,GAAG,MAAM,GAAG,OAAO,GAAG,QAAQ,GAAG,UAAU,GAAG,QAAQ,GAAG,cAAc,GAAG,QAAQ,GAAG,MAAM,GAAG,QAAQ,CAAC;QAC3L,QAAQ,CAAC,EAAE,MAAM,CAAC;QAClB,OAAO,CAAC,EAAE,MAAM,CAAC;QACjB,WAAW,CAAC,EAAE,MAAM,CAAC;QACrB,QAAQ,CAAC,EAAE,MAAM,CAAC;QAClB,UAAU,CAAC,EAAE,OAAO,CAAC;QACrB,cAAc,CAAC,EAAE,MAAM,CAAC;QACxB,aAAa,CAAC,EAAE,MAAM,CAAC;QACvB,UAAU,CAAC,EAAE,MAAM,CAAC;QACpB,SAAS,CAAC,EAAE,MAAM,CAAC;QACnB,UAAU,CAAC,EAAE,OAAO,CAAC;QACrB,cAAc,CAAC,EAAE,QAAQ,GAAG,MAAM,GAAG,MAAM,GAAG,QAAQ,GAAG,OAAO,CAAC;QACjE,IAAI,CAAC,EAAE,MAAM,CAAC;QACd,OAAO,CAAC,EAAE,MAAM,CAAC;QACjB,YAAY,CAAC,EAAE,OAAO,CAAC;QACvB,cAAc,CAAC,EAAE,OAAO,CAAC;QACzB,UAAU,CAAC,EAAE,OAAO,CAAC;QACrB,UAAU,CAAC,EAAE,OAAO,GAAG,MAAM,CAAC;QAC9B,MAAM,CAAC,EAAE,OAAO,CAAC;QACjB,QAAQ,CAAC,EAAE,OAAO,CAAC;QACnB,aAAa,CAAC,EAAE,MAAM,CAAC;QACvB,MAAM,CAAC,EAAE,OAAO,CAAC;QACjB,KAAK,CAAC,EAAE,MAAM,CAAC;QACf,QAAQ,CAAC,EAAE,MAAM,CAAC;QAClB,OAAO,CAAC,EAAE,MAAM,CAAC;QACjB,WAAW,CAAC,EAAE,MAAM,CAAC;KACxB,WACQ;QAAE,QAAQ,EAAE,MAAM,CAAA;KAAE,KAC9B,OAAO,CAAC,MAAM,CAAC;EA4DzB"}
+{"version":3,"file":"weave.d.ts","sourceRoot":"","sources":["../../../src/plugin/tools/weave.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAgCxB,wBAAgB,eAAe;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;oBAsFb;QACF,OAAO,EAAE,UAAU,GAAG,MAAM,GAAG,QAAQ,GAAG,SAAS,GAAG,aAAa,GAAG,cAAc,GAAG,MAAM,GAAG,OAAO,GAAG,QAAQ,GAAG,UAAU,GAAG,QAAQ,GAAG,cAAc,GAAG,QAAQ,GAAG,MAAM,GAAG,QAAQ,CAAC;QAC3L,QAAQ,CAAC,EAAE,MAAM,CAAC;QAClB,OAAO,CAAC,EAAE,MAAM,CAAC;QACjB,WAAW,CAAC,EAAE,MAAM,CAAC;QACrB,QAAQ,CAAC,EAAE,MAAM,CAAC;QAClB,UAAU,CAAC,EAAE,OAAO,CAAC;QACrB,cAAc,CAAC,EAAE,MAAM,CAAC;QACxB,aAAa,CAAC,EAAE,MAAM,CAAC;QACvB,UAAU,CAAC,EAAE,MAAM,CAAC;QACpB,SAAS,CAAC,EAAE,MAAM,CAAC;QACnB,UAAU,CAAC,EAAE,OAAO,CAAC;QACrB,cAAc,CAAC,EAAE,QAAQ,GAAG,MAAM,GAAG,MAAM,GAAG,QAAQ,GAAG,OAAO,CAAC;QACjE,IAAI,CAAC,EAAE,MAAM,CAAC;QACd,OAAO,CAAC,EAAE,MAAM,CAAC;QACjB,YAAY,CAAC,EAAE,OAAO,CAAC;QACvB,cAAc,CAAC,EAAE,OAAO,CAAC;QACzB,UAAU,CAAC,EAAE,OAAO,CAAC;QACrB,UAAU,CAAC,EAAE,OAAO,GAAG,MAAM,CAAC;QAC9B,MAAM,CAAC,EAAE,OAAO,CAAC;QACjB,QAAQ,CAAC,EAAE,OAAO,CAAC;QACnB,aAAa,CAAC,EAAE,MAAM,CAAC;QACvB,MAAM,CAAC,EAAE,OAAO,CAAC;QACjB,KAAK,CAAC,EAAE,MAAM,CAAC;QACf,QAAQ,CAAC,EAAE,MAAM,CAAC;QAClB,OAAO,CAAC,EAAE,MAAM,CAAC;QACjB,WAAW,CAAC,EAAE,MAAM,CAAC;KACxB,WACQ;QAAE,QAAQ,EAAE,MAAM,CAAA;KAAE,KAC9B,OAAO,CAAC,MAAM,CAAC;EA4DzB"}

package/dist/plugin/tools/weave.js

@@ -23,6 +23,7 @@ import { createWeaveWorktree, listWeaveWorktrees, resolveWeaveWorktree, removeWe
 import { ensureGitRepo, stageAllChanges, listStagedFiles, hasStagedChanges, commitStagedChanges } from '../../weave/git.js';
 import { scanFilesForSecrets, loadSecretScanConfig, shouldBlockOnFindings, formatSecretScanReport } from '../../weave/security/secret-scan.js';
 import { searchTroubleshooting, recordTroubleshooting, GlobalKnowledge } from '../../weave/knowledge/global.js';
+import { getEffectiveGdcConfig, runGdcMachineCommand, countGdcCheckIssues, } from '../../weave/gdc.js';
 // ============================================================================
 // Tool Factory
 // ============================================================================
@@ -292,6 +293,174 @@ function formatRefinePlanResult(title, outcome) {
     }
     return lines.join('\n');
 }
+function pickLogTail(text, maxLength = 180) {
+    if (!text)
+        return '';
+    const lines = text.split(/\r?\n/).map(line => line.trim()).filter(Boolean);
+    if (lines.length === 0)
+        return '';
+    return sanitizeLessonText(lines[lines.length - 1], maxLength);
+}
+function formatGdcCommandLine(label, result) {
+    const parts = [];
+    parts.push(result.exitCode === 0 ? 'PASS' : `FAIL(exit=${result.exitCode})`);
+    if (result.timedOut)
+        parts.push('timeout');
+    if (result.transportError)
+        parts.push(sanitizeLessonText(result.transportError, 140));
+    if (result.parseError)
+        parts.push(`parse=${sanitizeLessonText(result.parseError, 120)}`);
+    const detail = pickLogTail(result.stderr || result.stdout);
+    if (detail)
+        parts.push(`detail=${detail}`);
+    return `- ${label}: ${parts.join(' | ')}`;
+}
+async function runGdcVerifyGate(basePath) {
+    const gdc = getEffectiveGdcConfig(basePath);
+    if (!gdc.enabled) {
+        return {
+            applied: false,
+            passed: true,
+            report: '',
+        };
+    }
+    const lines = [];
+    lines.push('### GDC Pre-Verify Gate');
+    lines.push('');
+    lines.push(`- mode: ${gdc.strictVerify ? 'strict' : 'lenient'}`);
+    lines.push(`- binary: \`${gdc.binPath}\``);
+    const syncResult = await runGdcMachineCommand({
+        basePath,
+        command: 'sync',
+        config: gdc,
+    });
+    lines.push(formatGdcCommandLine('sync', syncResult));
+    const syncInfraFailure = Boolean(syncResult.transportError)
+        || (syncResult.exitCode !== 0 && syncResult.exitCode !== 2);
+    const syncMachineParseFailure = Boolean(syncResult.parseError && syncResult.exitCode === 0);
+    if (syncInfraFailure || syncMachineParseFailure) {
+        if (gdc.strictVerify) {
+            lines.push('');
+            lines.push('❌ Strict mode blocks verification when GDC sync cannot be trusted.');
+            return {
+                applied: true,
+                passed: false,
+                failedAt: 'GDC Sync',
+                report: lines.join('\n'),
+            };
+        }
+        lines.push('');
+        lines.push('⚠️ Proceeding without strict GDC sync gate (lenient mode).');
+        return {
+            applied: true,
+            passed: true,
+            report: lines.join('\n'),
+        };
+    }
+    const checkResult = await runGdcMachineCommand({
+        basePath,
+        command: 'check',
+        config: gdc,
+    });
+    lines.push(formatGdcCommandLine('check', checkResult));
+    if (checkResult.exitCode === 2) {
+        lines.push('');
+        lines.push('❌ Blocking GDC check issues detected (exit code 2).');
+        return {
+            applied: true,
+            passed: false,
+            failedAt: 'GDC Check',
+            report: lines.join('\n'),
+        };
+    }
+    const checkInfraFailure = Boolean(checkResult.transportError)
+        || (checkResult.exitCode !== 0 && checkResult.exitCode !== 2);
+    if (checkInfraFailure) {
+        if (gdc.strictVerify) {
+            lines.push('');
+            lines.push('❌ Strict mode blocks verification when GDC check fails to run.');
+            return {
+                applied: true,
+                passed: false,
+                failedAt: 'GDC Check',
+                report: lines.join('\n'),
+            };
+        }
+        lines.push('');
+        lines.push('⚠️ GDC check execution failed, but lenient mode allows verification to continue.');
+        return {
+            applied: true,
+            passed: true,
+            report: lines.join('\n'),
+        };
+    }
+    const counts = countGdcCheckIssues(checkResult.data);
+    lines.push(`- check summary: errors=${counts.errors}, warnings=${counts.warnings}, info=${counts.infos}, issues=${counts.issueCount}`);
+    if (counts.errors > 0) {
+        lines.push('');
+        lines.push('❌ Blocking GDC check errors found. Resolve them before build/test verification.');
+        return {
+            applied: true,
+            passed: false,
+            failedAt: 'GDC Check',
+            report: lines.join('\n'),
+        };
+    }
+    if (checkResult.parseError) {
+        if (gdc.strictVerify) {
+            lines.push('');
+            lines.push('❌ Strict mode requires parseable GDC machine output.');
+            return {
+                applied: true,
+                passed: false,
+                failedAt: 'GDC Check Parse',
+                report: lines.join('\n'),
+            };
+        }
+        lines.push('');
+        lines.push('⚠️ GDC check output could not be parsed; continuing in lenient mode.');
+    }
+    lines.push('');
+    lines.push('✅ GDC gate passed.');
+    return {
+        applied: true,
+        passed: true,
+        report: lines.join('\n'),
+    };
+}
+async function runGdcPrepareSync(basePath) {
+    const gdc = getEffectiveGdcConfig(basePath);
+    if (!gdc.enabled || !gdc.autoSyncOnPrepare) {
+        return {
+            applied: false,
+            report: '',
+        };
+    }
+    const lines = [];
+    lines.push('### GDC Prepare Sync');
+    lines.push('');
+    lines.push(`- binary: \`${gdc.binPath}\``);
+    const syncResult = await runGdcMachineCommand({
+        basePath,
+        command: 'sync',
+        config: gdc,
+    });
+    lines.push(formatGdcCommandLine('sync', syncResult));
+    const syncInfraFailure = Boolean(syncResult.transportError)
+        || (syncResult.exitCode !== 0 && syncResult.exitCode !== 2);
+    const syncMachineParseFailure = Boolean(syncResult.parseError && syncResult.exitCode === 0);
+    lines.push('');
+    if (syncInfraFailure || syncMachineParseFailure) {
+        lines.push('⚠️ GDC sync failed during prepare; continuing without blocking.');
+    }
+    else {
+        lines.push('✅ GDC sync completed before research/plan generation.');
+    }
+    return {
+        applied: true,
+        report: lines.join('\n'),
+    };
+}
 async function handleResearch(args, basePath) {
     const { docsPath, projectName } = args;
     if (!docsPath) {
@@ -521,6 +690,7 @@ async function handlePrepare(args, basePath) {
     }
     const resolvedDocsPath = resolveUnderBase(basePath, docsPath);
     const intakeResult = await intake({ docsPath: resolvedDocsPath });
+    const gdcPrepareSync = await runGdcPrepareSync(basePath);
     const researchResult = await writeResearchReport({
         docsPath: resolvedDocsPath,
         intake: intakeResult,
@@ -552,6 +722,10 @@ async function handlePrepare(args, basePath) {
     });
     const lines = [];
     lines.push('## ✅ Weave Prepare 완료\n');
+    if (gdcPrepareSync.applied && gdcPrepareSync.report) {
+        lines.push(gdcPrepareSync.report);
+        lines.push('');
+    }
     lines.push(researchResult.summary);
     lines.push('');
     lines.push(specResult.summary);
@@ -683,6 +857,24 @@ async function handleFlow(args, basePath) {
     lines.push('');
     lines.push('### 3) Verify');
     lines.push('');
+    const reviewLines = [
+        `Flow executed for ${resolvedPhaseId}.`,
+        `Plan gate: ${planGate.passed ? 'PASS' : 'BYPASS'} (${planGate.nonTrivial ? 'non-trivial' : 'simple'} scope).`,
+    ];
+    const gdcGate = await runGdcVerifyGate(basePath);
+    if (gdcGate.applied && gdcGate.report) {
+        lines.push(gdcGate.report);
+        lines.push('');
+    }
+    if (!gdcGate.passed) {
+        lines.push(`❌ Verification failed at: ${gdcGate.failedAt || 'GDC Gate'}`);
+        reviewLines.push(`Flow stopped at GDC gate for ${resolvedPhaseId}: ${gdcGate.failedAt || 'GDC Gate'}.`);
+        await syncWorkflowArtifacts(basePath, manager, {
+            phaseId: resolvedPhaseId,
+            reviewLines,
+        });
+        return lines.join('\n');
+    }
     const verification = await runAIVerification({
         projectType: args.projectType || 'unknown',
         projectPath: basePath,
@@ -692,12 +884,11 @@ async function handleFlow(args, basePath) {
     });
     const verificationReport = generateVerificationReport(verification.results);
     lines.push(verificationReport);
-    const reviewLines = [
-        `Flow executed for ${resolvedPhaseId}.`,
-        `Plan gate: ${planGate.passed ? 'PASS' : 'BYPASS'} (${planGate.nonTrivial ? 'non-trivial' : 'simple'} scope).`,
-    ];
     reviewLines.push(`Craft prepared execution context for ${resolvedPhaseId}.`);
     reviewLines.push('Phase implementation/verification proceeds outside the legacy auto loop.');
+    if (gdcGate.applied) {
+        reviewLines.push(`GDC pre-verify gate passed for ${resolvedPhaseId}.`);
+    }
     if (!verification.passed) {
         lines.push('');
         lines.push(`❌ Verification failed at: ${verification.failedAt || 'unknown'}`);
@@ -970,6 +1161,15 @@ async function handleWorktree(args, basePath) {
 async function handleVerify(args, basePath) {
     const projectType = args.projectType || 'unknown';
     const mode = args.verifyMode || 'full';
+    const gdcGate = await runGdcVerifyGate(basePath);
+    const sections = [];
+    if (gdcGate.applied && gdcGate.report) {
+        sections.push(gdcGate.report);
+    }
+    if (!gdcGate.passed) {
+        sections.push(`❌ Verification failed at: ${gdcGate.failedAt || 'GDC Gate'}`);
+        return sections.join('\n\n');
+    }
     const verification = await runAIVerification({
         projectType,
         projectPath: basePath,
@@ -978,26 +1178,27 @@ async function handleVerify(args, basePath) {
         mode,
     });
     const report = generateVerificationReport(verification.results);
+    sections.push(report);
     if (verification.results.length === 0) {
-        return [
-            report,
+        sections.push([
             '',
             '> No verification commands detected for this project.',
             '> Provide scripts/tools (package.json, go.mod, Cargo.toml, pyproject.toml, *.sln) or pass projectType hint.',
-        ].join('\n');
+        ].join('\n'));
+        return sections.join('\n\n');
     }
     if (!verification.passed) {
-        return [
-            report,
+        sections.push([
             '',
             `❌ Verification failed at: ${verification.failedAt || 'unknown'}`,
-        ].join('\n');
+        ].join('\n'));
+        return sections.join('\n\n');
     }
-    return [
-        report,
+    sections.push([
         '',
         '✅ Verification passed.',
-    ].join('\n');
+    ].join('\n'));
+    return sections.join('\n\n');
 }
 async function handleTroubleshoot(args) {
     const { error, projectType } = args;
@@ -1086,6 +1287,24 @@ async function handleApprove(args, basePath) {
         return message;
     };
     if (!skipVerify) {
+        const reportSections = [];
+        const gdcGate = await runGdcVerifyGate(basePath);
+        if (gdcGate.applied && gdcGate.report) {
+            reportSections.push(gdcGate.report);
+        }
+        if (!gdcGate.passed) {
+            return finalizeApprove([
+                ...reportSections,
+                `❌ Verification failed at: ${gdcGate.failedAt || 'GDC Gate'}`,
+                '',
+                invokedByCraft
+                    ? 'Fix the failures and rerun `weave craft`.'
+                    : 'Fix the failures and re-run `weave craft`.',
+                'You can also run: `weave command=verify`',
+            ].filter(Boolean).join('\n\n'), [
+                `Finalization blocked at GDC gate for ${resolvedPhaseId}: ${gdcGate.failedAt || 'GDC Gate'}.`,
+            ]);
+        }
         const verification = await runAIVerification({
             projectType: projectType || 'unknown',
             projectPath: basePath,
@@ -1093,7 +1312,8 @@ async function handleApprove(args, basePath) {
             enableScreenshots: false,
             mode: verifyMode || 'full',
         });
-        const report = generateVerificationReport(verification.results);
+        reportSections.push(generateVerificationReport(verification.results));
+        const report = reportSections.join('\n\n');
         if (!verification.passed) {
             return finalizeApprove([
                 report,