feat: add --strict flag to lint for CI/pre-commit enforcement

- ccg lint: report only (exit 0)
- ccg lint --strict: exit 1 if any issues found (blocks commit)
- Pre-commit hook now uses --strict by default

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>

Author: tae2089

internal/cli/hooks.go

@@ -14,7 +14,7 @@ const hookGuardEnd = "# --- ccg hook end ---"
 
 const hookBody = `
 ` + hookGuardBegin + `
-ccg build . && ccg docs && ccg lint
+ccg build . && ccg docs && ccg lint --strict
 ` + hookGuardEnd + `
 `
 

internal/cli/lint.go

@@ -12,6 +12,7 @@ import (
 func newLintCmd(deps *Deps) *cobra.Command {
 	var outDir string
 	var excludePatterns []string
+	var strict bool
 
 	cmd := &cobra.Command{
 		Use:   "lint",
@@ -80,11 +81,16 @@ func newLintCmd(deps *Deps) *cobra.Command {
 					len(report.Orphans), len(report.Missing), len(report.Stale), len(report.Unannotated))
 			}
 
+			if strict && total > 0 {
+				return fmt.Errorf("lint found %d issues", total)
+			}
+
 			return nil
 		},
 	}
 
 	cmd.Flags().StringVar(&outDir, "out", "docs", "Documentation directory to lint")
 	cmd.Flags().StringArrayVar(&excludePatterns, "exclude", nil, "Exclude files/paths matching pattern (repeatable)")
+	cmd.Flags().BoolVar(&strict, "strict", false, "Exit with error if any issues are found (useful for CI/pre-commit)")
 	return cmd
 }

internal/cli/lint_test.go

@@ -166,3 +166,52 @@ func TestLintCommand_ReportsUnannotated(t *testing.T) {
 		t.Errorf("expected 'unannotated' label in output, got:\n%s", out)
 	}
 }
+
+func TestLintCommand_Strict_FailsOnIssues(t *testing.T) {
+	deps, stdout, stderr, db := setupLintTest(t)
+
+	db.Create(&model.Node{
+		QualifiedName: "pkg/bare.go::Bare",
+		Kind:          model.NodeKindFunction,
+		Name:          "Bare",
+		FilePath:      "pkg/bare.go",
+		StartLine:     1, EndLine: 5,
+		Hash: "h1", Language: "go",
+	})
+
+	outDir := t.TempDir()
+	err := executeCmd(deps, stdout, stderr, "lint", "--out", outDir, "--strict")
+	if err == nil {
+		t.Fatal("expected error with --strict when issues exist")
+	}
+}
+
+func TestLintCommand_Strict_PassesWhenClean(t *testing.T) {
+	deps, stdout, stderr, db := setupLintTest(t)
+
+	fn := model.Node{
+		QualifiedName: "pkg/ok.go::Ok",
+		Kind:          model.NodeKindFunction,
+		Name:          "Ok",
+		FilePath:      "pkg/ok.go",
+		StartLine:     1, EndLine: 5,
+		Hash: "h1", Language: "go",
+	}
+	db.Create(&fn)
+	db.Create(&model.Annotation{
+		NodeID: fn.ID,
+		Tags:   []model.DocTag{{Kind: model.TagIntent, Value: "ok", Ordinal: 0}},
+	})
+
+	outDir := t.TempDir()
+	// Generate docs first
+	if err := executeCmd(deps, stdout, stderr, "docs", "--out", outDir); err != nil {
+		t.Fatalf("docs: %v", err)
+	}
+
+	stdout.Reset()
+	err := executeCmd(deps, stdout, stderr, "lint", "--out", outDir, "--strict")
+	if err != nil {
+		t.Fatalf("expected no error with --strict when clean, got: %v", err)
+	}
+}