apache / arrow

	github actions npm yarn jest dependabot gemfile make docker
Standard analyses:
		Main Code: 515,805 LOC (2828 files) = CC (41%) + H (20%) + CPP (9%) + PY (4%) + CMAKE (4%) + CS (3%) + TS (2%) + PYX (2%) + RB (2%) + PXI (1%) + M (1%) + C (1%) + PXD (1%) + HPP (<1%) + SWIFT (<1%) + IN (<1%) + PROTO (<1%) + JS (<1%) + VALA (<1%) + JINJA (<1%) + THRIFT (<1%) + GEMSPEC (<1%) + MM (<1%) + GO (<1%) + LUA (<1%) + AWK (<1%) + HTML (<1%) + TOML (<1%) + YAML (<1%) + XML (<1%) + PROPS (<1%) + CFG (<1%) + MJS (<1%) + CJS (<1%) + CSS (<1%) + TARGETS (<1%) Secondary code: Test: 307,609 LOC (1176); Generated: 36,344 LOC (86); Build & Deploy: 10,486 LOC (192); Other: 28,157 LOC (317);
		File Size: 32% long (>1000 LOC), 24% short (<= 200 LOC)
		Logical Component Decomposition: primary (13 components)
		10 years, 11 months old 96% of code older than 365 days 28% of code not updated in the past 365 days
		20% of code updated more than 50 times Also see temporal dependencies for files frequently changed in same commits.
		Goals: Keep the system simple and easy to change (4)
Experimental analyses (less reliable heuristic analyses):
		Unit Size: 5% long (>100 LOC), 57% short (<= 10 LOC)
		Conditional Complexity: 4% complex (McCabe index > 50), 68% simple (McCabe index <= 5)
		Static Component Dependencies: primary (13 components)

	Features of interest: TODOs 183 files

All Analysis Reports

Source Code Overview

Components

Temporal Dependencies

Duplication

File Size

File Age & Freshness

File Change Frequency

Commits

Contributors

Unit Size*

Conditional Complexity*

Features of Interest

All Metrics

Goals & Controls

Component Dependencies*

Trend

Notes & Findings

Overall Activity Per Year

Latest commit date: 2025-05-07

Reference analysis date: 2025-05-07

108

commits
(30 days)

36

contributors
(30 days)

399	1603	2090	2252	2425	2540	2399	1610	1241	403	1	1
83	257	275	289	257	253	227	185	107	45	1	1
2025	2024	2023	2022	2021	2020	2019	2018	2017	2016	2015	2014

Activity Per File Extension

commits

	2025	2024	2023	2022	2021	2020	2019	2018	2017	2016	2015	2014
	118	460	648	632	778	768	693	493	463	223			cc
	88	294	451	443	591	605	580	449	425	199	1	1	h
	59	264	287	430	409	537	461	427	342	64			py
	66	251	221	304	289	315	280	156	55	17			yaml
	49	65	93	109	107	108	145	78	65				rb
	26	80	135	122	98	115	178	122	85	23			cmake
		92	50	60	39	46	67	58	41	16			xml
pxi	12	78	86	82	67	128	142	149	91				pxi
pxd	23	56	54	94	118	166	127	94	110	37			pxd
	2	69	199	154	53	20	63	25	7				go
	21	49	82	121	197	150	140	97	93	3			cpp
	21	38	86	124	140	144	98	64	109	49			pyx
	4	42	55	6	7	23	21	1					cs
in	11	24	44	49	37	37	33	43	21	2			in
	4	21	24	20	25	2	32	31	14				ts
	4	20	13										swift
	3	11	19	22	10								jinja
	3	11	4	2	41	84	52	14					toml
proto	2	11	14	10	7	6	10	4					proto
		12	15	10	34	2	14	18	13				js
	1	11	23	15	32	24	23	22	33				hpp
	1	11	103	2	1		2	1					m
props	2	6	7	5	5	13	11	1					props
	4	3	6	3	5		16	14	24				html
	2	2	1	5	5	2	11	8					gemspec
		3	8	13	4	3	7	3	13				c
	1	1	4	1	6	1		1	1				css
		2	4	4									cjs
vala		1		1									vala
	1		3		1	5	3	6	4	3			thrift
		1			1	2							mm
cfg		1	2	3		1	2		1	2			cfg
targets						1							targets
						1			2				awk
mjs			1	1				1					mjs
lua				1			1		7				lua

contributors

	2025	2024	2023	2022	2021	2020	2019	2018	2017	2016	2015	2014
	44	104	102	117	104	90	88	71	37	26			cc
	31	80	64	79	67	70	64	66	36	8			py
	33	74	77	100	90	77	70	61	36	24	1	1	h
	15	49	44	49	50	40	37	32	14	6			yaml
pxd	13	33	26	31	26	33	24	21	14	5			pxd
pxi	9	33	31	31	22	29	18	33	13				pxi
	11	31	39	42	30	28	25	15	13	6			pyx
	10	28	31	30	30	30	34	34	10	8			cmake
	2	31	49	30	7	15	11	6	1				go
	7	18	25	26	26	20	18	12	3	2			cpp
	7	14	19	23	19	21	12	8	2				rb
		20	21	20	19	14	21	19	13	9			xml
	3	12	15	6	6	13	7	1					cs
	3	8	4	2	20	25	15	5					toml
proto	2	9	9	7	5	6	8	4					proto
	4	6	12	8	4	2	9	4	5				ts
in	5	4	10	14	11	11	11	13	7	2			in
	3	6	6	9	4								jinja
		6	9	6	7	2	7	5	4				js
	1	5	5	3	7	8	6	6	2				hpp
	3	3	4	3	3		12	12	9				html
props	2	3	2	3	1	4	4	1					props
	2	2	2										swift
	1	2	5	1	1		2	1					m
	1	1	1	1	1	1	4	3					gemspec
		2	4	5	2	3	6	2	3				c
	1	1	2	1	2	1		1	1				css
		1	4	2									cjs
vala		1		1									vala
	1		2		1	3	3	3	4	2			thrift
		1			1	2							mm
cfg		1	1	3		1	2		1	1			cfg
targets						1							targets
						1			2				awk
mjs			1	1				1					mjs
lua				1			1		1				lua

Visual Code Explorers

MAIN (2828)	Circles	Sunburst
TEST (1176)	Circles	Sunburst
BUILD AND DEPLOYMENT (192)	Circles	Sunburst
GENERATED (86)	Circles	Sunburst
OTHER (317)	Circles	Sunburst

File Visualizations

File size views:

File age views:

	files grouped by age category files grouped by folder
	files grouped by freshness category files grouped by folder

File change frequency views:

Contributors per file views:

Contributor Visualizations

Contributor dependency views:

past 30 days: graphviz | 2D graph | 2D graph (with files) | 2D graph (with shared files only) | 3D graph | 3D graph (with files) | 3D graph (with shared files only)
past 3 months: graphviz | 2D graph | 2D graph (with files) | 2D graph (with shared files only) | 3D graph | 3D graph (with files) | 3D graph (with shared files only)
past 6 months: graphviz | 2D graph | 2D graph (with files) | 2D graph (with shared files only) | 3D graph | 3D graph (with files) | 3D graph (with shared files only)
past year: graphviz | 2D graph | 2D graph (with files) | 2D graph (with shared files only) | 3D graph | 3D graph (with files) | 3D graph (with shared files only)

Components and Dependencies Visualizations

Components

Temporal Dependencies

Duplication

Commits Racing Charts

30 days

3 months

6 months

PRIMARY (13)

Bubble Chart

Tree Map

graphviz

2D

3D

graphviz

2D

3D

graphviz

2D

3D

Duplication Graph

All Time

12 Months

File Dependencies Visualizations

Temporal dependencies among files:

past 30 days: graphviz | 2D graph | 2D graph (with commits) | 3D graph | 3D graph (with commits)
past 3 months: graphviz | 2D graph | 2D graph (with commits) | 3D graph | 3D graph (with commits)
past 6 months: graphviz | 2D graph | 2D graph (with commits) | 3D graph | 3D graph (with commits)

Units Visualizations

Unit size and conditional complexity views:

Lists of Files Per Scope

Analysis Results

CONFIGURATION: JSON
ALL ANALYSIS RESULTS: JSON
DUPLICATES: TXT | JSON
UNITS: TXT | JSON
CONTRIBUTORS: TXT | JSON
LOGICAL DECOMPOSITIONS: JSON
CONCERNS: JSON
CONTROLS: TXT
ALL METRICS: TXT

Zipped Files

GIT HISTORY: ZIP
ALL FILES IN ALL ANALYSIS SCOPES: ZIP

Generative AI tools, like ChatGPT or Gemini, can help you explore and discuss various aspects of source code repositories using simple prompts and file uploads. Sokrates provides you with curated data that you can use to analyze your source code further.

Example Prompt 1: Repository Evolution Analyzer (based on git history)

Try on: OpenAI ChatGPT | Claude.ai Chat | Google Gemini

Files to upload: git-history.zip

Prompt:

You are an experienced software architect tasked with analyzing Git commit history.
Context:
- Repository Name: apache / arrow
- Repository Description: Apache Arrow is the universal columnar format and multi-language toolbox for fast data interchange and in-memory analytics
- Data Provided: A plain text file containing Git commit records. Source code is not available.
- Analysis Basis: Your analysis must be based solely on inferring context from the provided file paths, file names, file extensions, commit timestamps, and author information within the commit records.

Input Format:
The commit records are provided in the following format per line:
[YYYY-MM-DD] [author email] [commit hash] [file path changed]

Requested Insights:

Please analyze the provided commit history and generate a report covering the following sections:

1. Management Summary
- Provide a concise, high-level overview suitable for non-technical stakeholders.
- Summarize the repository's likely purpose, main development phases observed, and key takeaways about the team structure/activity.

2. Functional Overview
- Based only on file/module/class names, infer and describe the primary functions and capabilities of the software in this repository.
- What services or features does the codebase seem to support?

3. Key Business/Domain Concepts
- Identify and list core business or domain concepts reflected in the file and directory names (e.g., reporting, analytics, data export, user management, sourcecode analysis, landscape, visualization).

4. Inferred Architecture & Design
- Infer potential architectural patterns (e.g., modular, layered, microservices) based on directory structures and file naming conventions.
- Highlight notable design choices evident from the structure, such as separation of concerns (e.g., common module), use of configuration files, or templating engines.

5. Inferred Technology Stack
- List the programming languages, frameworks, libraries, and tools likely used, based on file extensions (.java, .py, .js, .html, .xml, .yml, pom.xml, dockerfile), configuration files, and common directory structures (e.g., /src/main/java).
- Categorize these technologies where possible (e.g., Backend, Frontend, Build, Infrastructure).

6. Logical Components / Modules
- Identify the major logical components or modules suggested by the directory structure (e.g., codeanalyzer, reports, cli, common, web).
- Briefly describe the inferred purpose of each major component.

7. Evolution by Year
- Summarize the apparent focus of development activity for each year present in the commit history.
- Assign a thematic title to each year (e.g., "Year 1: Foundation & Core Analysis", "Year 2: Reporting & Visualization Expansion").

8. Trends Over Time
Identify and describe significant trends observed across the years, such as:
- Shifts in technology usage (e.g., introduction of Docker).
- Changes in module activity (e.g., increased focus on landscape analysis).
- Signs of project maturity, expansion into new areas, or periods of focused maintenance.
9. Team Dynamics
- Analyze contributor patterns based on author emails and commit frequency:
 - Identify core maintainer(s) vs. occasional contributors.
 - Describe observable contribution trends (e.g., stable team, high turnover, reliance on a single developer).
 - Note any appearance of automated contributors (e.g., Dependabot).
10. Risk Analysis:
- Based on the findings in all previous sections (Team Dynamics, Technology, Architecture, Evolution), identify potential key risks for the project.
- Examples: Key person dependency, technology obsolescence, maintainability challenges due to complexity, potential scalability bottlenecks, bus factor.

Input File:
You will receive the commit records in a plain text file. Please parse this file to perform your analysis.

Example Prompt 2: File name conventions

Try on: OpenAI ChatGPT | Claude.ai Chat | Google Gemini

Files to upload: files.json

Prompt:

Example Prompt 3: Technology analyzer (based of file paths)

Try on: OpenAI ChatGPT | Claude.ai Chat | Google Gemini

Files to upload: files.json

Prompt:

Analyze the provided list of file paths to identify as many technologies, frameworks, tools, programming languages, cloud services, and architectural patterns used in the project as possible.

**Input:**
Please analyze the following list of file structures (provided as a list of strings or a JSON object containing file paths and optionally extensions/metadata):

*(Example: A JSON array like the one previously provided, or a simple list like `["src/server.ts", "Dockerfile", "tests/e2e/spec.cy.js", "infra/main.tf"]`)*

**Analysis Instructions:**
When performing the analysis, please consider the following:

1. **File Extensions:** Identify languages and configuration types (e.g., `.ts`, `.js`, `.py`, `.java`, `.tf`, `.yml`, `.hcl`, `.css`, `.html`).
2. **Directory Structure & Naming:** Look for conventional directory names (`src`, `tests`, `infra`, `docs`, `cicd`) and names indicating specific components or frameworks (`packages/bff`, `features`, `controllers`, `services`, `cypress`).
3. **Specific Filenames:** Identify standard configuration or definition files (e.g., `package.json`, `pom.xml`, `docker-compose.yml`, `Dockerfile`, `Jenkinsfile`, `webpack.config.js`, `tsconfig.json`, `requirements.txt`, `terragrunt.hcl`, `lint-staged.config.js`, `commitlint.config.js`).
4. **Keywords in Paths:** Look for names of known technologies, tools, frameworks, or cloud providers within the paths (e.g., `aws`, `azure`, `lambda`, `sqs`, `react`, `nest`, `k6`, `datadog`, `pm2`).

**Output:**
Please present the findings as a list of identified technologies. If possible, group them into relevant categories such as:

* Programming Languages
* Frameworks & Runtimes
* Testing Tools
* Infrastructure as Code / Cloud Providers
* Containerization & Orchestration
* Build Tools / Bundlers
* Databases (if identifiable)
* Monitoring & Logging
* CI/CD & Dev Tools
* Architectural Patterns