Pipeline.Codebase.Context (pipeline v0.0.1)

View Source

Codebase discovery and context analysis system.

Automatically analyzes project structure and provides intelligent context to pipeline steps including project type detection, file structure analysis, dependency parsing, and git information integration.

Summary

Types

file_info()
git_info()
project_type()
structure_info()
t()

Functions

discover(workspace_dir)

Discover and analyze codebase context for a given workspace directory.

find_related_files(context, file_path)

Find files related to a given file path using various heuristics.

get_summary(context)

Get a summary of the codebase for use in prompts.

query_files(context, criteria)

Query files by various criteria.

to_template_vars(context)

Convert context to template variables for use in pipeline steps.

Types

file_info()

@type file_info() :: %{
  type: String.t(),
  size: non_neg_integer(),
  modified: DateTime.t(),
  language: String.t() | nil
}

git_info()

@type git_info() :: %{
  branch: String.t() | nil,
  commit: String.t() | nil,
  status: String.t() | nil,
  recent_commits: [String.t()]
}

project_type()

@type project_type() :: :elixir | :javascript | :python | :rust | :go | :unknown

structure_info()

@type structure_info() :: %{
  directories: [String.t()],
  main_files: [String.t()],
  test_files: [String.t()],
  config_files: [String.t()],
  source_files: [String.t()]
}

t()

@type t() :: %Pipeline.Codebase.Context{
  dependencies: map(),
  files: %{required(String.t()) => file_info()},
  git_info: git_info(),
  metadata: map(),
  project_type: project_type(),
  root_path: String.t(),
  structure: structure_info()
}

Functions

discover(workspace_dir)

@spec discover(String.t()) :: t()

Discover and analyze codebase context for a given workspace directory.

Examples

iex> context = Pipeline.Codebase.Context.discover("/path/to/project")
%Pipeline.Codebase.Context{
  project_type: :elixir,
  root_path: "/path/to/project",
  ...
}

get_summary(context)

@spec get_summary(t()) :: String.t()

Get a summary of the codebase for use in prompts.

query_files(context, criteria)

@spec query_files(
  t(),
  keyword()
) :: [String.t()]

Query files by various criteria.

to_template_vars(context)

@spec to_template_vars(t()) :: map()

Convert context to template variables for use in pipeline steps.

Examples

iex> context |> Pipeline.Codebase.Context.to_template_vars()
%{
  "codebase.project_type" => "elixir",
  "codebase.structure.main_files" => ["lib/my_app.ex"],
  ...
}