Skip to content

Update codebase artifacts (run 019f73a5)#1438

Merged
JayGhiya merged 2 commits into
devfrom
agents-md/019f73a5-c86
Jul 18, 2026
Merged

Update codebase artifacts (run 019f73a5)#1438
JayGhiya merged 2 commits into
devfrom
agents-md/019f73a5-c86

Conversation

@JayGhiya

@JayGhiya JayGhiya commented Jul 18, 2026

Copy link
Copy Markdown
Member

Summary

  • Codebase artifact update for run 019f73a5-c86c-760d-979b-c3489180b525
  • Updated files: 24

Changed Files

  • unoplat-code-confluence-cli/AGENTS.md
  • unoplat-code-confluence-cli/dependencies_overview.md
  • unoplat-code-confluence-cli/business_domain_references.md
  • unoplat-code-confluence-docs/AGENTS.md
  • unoplat-code-confluence-docs/dependencies_overview.md
  • unoplat-code-confluence-docs/business_domain_references.md
  • unoplat-code-confluence-commons/AGENTS.md
  • unoplat-code-confluence-commons/business_domain_references.md
  • unoplat-code-confluence-frontend/AGENTS.md
  • unoplat-code-confluence-frontend/dependencies_overview.md
  • unoplat-code-confluence-frontend/business_domain_references.md
  • unoplat-code-confluence-frontend/app_interfaces.md
  • unoplat-code-confluence-openmetadata/AGENTS.md
  • unoplat-code-confluence-openmetadata/dependencies_overview.md
  • unoplat-code-confluence-openmetadata/business_domain_references.md
  • unoplat-code-confluence-query-engine/AGENTS.md
  • unoplat-code-confluence-query-engine/dependencies_overview.md
  • unoplat-code-confluence-query-engine/business_domain_references.md
  • unoplat-code-confluence-query-engine/app_interfaces.md
  • unoplat-code-confluence-ingestion/code-confluence-flow-bridge/AGENTS.md
  • unoplat-code-confluence-ingestion/code-confluence-flow-bridge/dependencies_overview.md
  • unoplat-code-confluence-ingestion/code-confluence-flow-bridge/business_domain_references.md
  • unoplat-code-confluence-ingestion/code-confluence-flow-bridge/app_interfaces.md
  • architecture.md

Summary by CodeRabbit

  • Documentation
    • Added a centralized architecture overview and system interaction diagram.
    • Updated component docs to reflect current capabilities, workflows, and domain responsibilities.
    • Refreshed endpoint/interface, business domain, data-reference, and dependency documentation across services (including health endpoints and revised route coverage).
    • Updated AGENTS workflow instructions and “generated from branch/dev” metadata for accuracy.
    • Improved interface/docs consistency by revising cited source references and related descriptions.

@claude

claude Bot commented Jul 18, 2026

Copy link
Copy Markdown

Claude encountered an error —— View job


I'll analyze this and get back to you.

@github-actions

Copy link
Copy Markdown
Contributor

🚀 Preview Deployment Ready!

Preview URL: https://head.unoplat-code-confluence-docs.pages.dev


Deployed via Cloudflare Pages

@coderabbitai

coderabbitai Bot commented Jul 18, 2026

Copy link
Copy Markdown

Review Change Stack

Caution

Review failed

The pull request is closed.

ℹ️ Recent review info
⚙️ Run configuration

Configuration used: defaults

Review profile: CHILL

Plan: Pro

Run ID: 92aeedc6-0f54-4700-b650-8d683f4eeee7

📥 Commits

Reviewing files that changed from the base of the PR and between 4bd97a1 and d5ac1a8.

📒 Files selected for processing (1)
  • unoplat-code-confluence-query-engine/AGENTS.md

📝 Walkthrough

Walkthrough

Added a canonical architecture document and refreshed generated documentation across CLI, commons, docs, frontend, Flow Bridge, OpenMetadata, and query-engine packages. Updates cover workflow commands, architecture links, domain descriptions, interface mappings, source references, provenance metadata, and dependency ordering or formatting.

Changes

Documentation Refresh

Layer / File(s) Summary
Canonical architecture and generated metadata
architecture.md, unoplat-code-confluence-*/AGENTS.md
Added the shared architecture diagram and updated generated commit metadata and architecture links.
CLI and commons reference updates
unoplat-code-confluence-cli/*, unoplat-code-confluence-commons/*
Updated CLI workflow descriptions, domain references, and dependency formatting.
Frontend and documentation-site references
unoplat-code-confluence-docs/*, unoplat-code-confluence-frontend/*
Refreshed workflow commands, domain descriptions, Zustand documentation, source-line mappings, and dependency entries.
Flow Bridge interface and domain references
unoplat-code-confluence-ingestion/code-confluence-flow-bridge/*
Updated endpoint inventories, domain references, source-line mappings, and dependency ordering.
Query engine and OpenMetadata references
unoplat-code-confluence-openmetadata/*, unoplat-code-confluence-query-engine/*
Updated workflow instructions, domain references, endpoint mappings, Temporal references, and dependency ordering.

Estimated code review effort: 2 (Simple) | ~15 minutes

Possibly related PRs

🚥 Pre-merge checks | ✅ 5
✅ Passed checks (5 passed)
Check name Status Explanation
Description Check ✅ Passed Check skipped - CodeRabbit’s high-level summary is enabled.
Title check ✅ Passed The title matches the main change: a broad update to codebase artifact documentation for run 019f73a5.
Docstring Coverage ✅ Passed No functions found in the changed files to evaluate docstring coverage. Skipping docstring coverage check.
Linked Issues check ✅ Passed Check skipped because no linked issues were found for this pull request.
Out of Scope Changes check ✅ Passed Check skipped because no linked issues were found for this pull request.
✨ Finishing Touches
🧪 Generate unit tests (beta)
  • Create PR with unit tests
  • Commit unit tests in branch agents-md/019f73a5-c86

Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out.

❤️ Share

Comment @coderabbitai help to get the list of available commands.

@coderabbitai coderabbitai Bot left a comment

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Actionable comments posted: 5

Caution

Some comments are outside the diff and can’t be posted inline due to platform limitations.

⚠️ Outside diff range comments (1)
unoplat-code-confluence-frontend/AGENTS.md (1)

1-1: 📐 Maintainability & Code Quality | 🟡 Minor | ⚡ Quick win

Fix the relative links to the root architecture document.

The canonical architecture.md is at repository root, but ./architecture.md resolves inside each service directory and will be broken.

  • unoplat-code-confluence-frontend/AGENTS.md#L118-L120: link to ../architecture.md.
  • unoplat-code-confluence-ingestion/code-confluence-flow-bridge/AGENTS.md#L139-L141: link to ../../architecture.md.
  • unoplat-code-confluence-openmetadata/AGENTS.md#L42-L44: link to ../architecture.md.
  • unoplat-code-confluence-query-engine/AGENTS.md#L91-L93: link to ../architecture.md.
🤖 Prompt for AI Agents
Verify each finding against current code. Fix only still-valid issues, skip the
rest with a brief reason, keep changes minimal, and validate.

In `@unoplat-code-confluence-frontend/AGENTS.md` at line 1, Update the
architecture document links in the AGENTS.md files for the frontend, flow
bridge, openmetadata, and query-engine components to point to the
repository-root architecture.md using the required relative paths:
../architecture.md for direct subdirectories and ../../architecture.md for the
nested flow-bridge directory.
🤖 Prompt for all review comments with AI agents
Verify each finding against current code. Fix only still-valid issues, skip the
rest with a brief reason, keep changes minimal, and validate.

Inline comments:
In `@unoplat-code-confluence-cli/AGENTS.md`:
- Around line 42-43: Update the Architecture links in
unoplat-code-confluence-cli/AGENTS.md lines 42-43,
unoplat-code-confluence-commons/AGENTS.md lines 66-67, and
unoplat-code-confluence-docs/AGENTS.md lines 72-74 from ./architecture.md to
../architecture.md so each points to the repository-root document.

In `@unoplat-code-confluence-cli/dependencies_overview.md`:
- Line 6: Restore inline-code formatting around the _dir and _path API suffixes
in the platformdirs description, using backticks so both identifiers render as
code and avoid Markdown emphasis parsing.

In `@unoplat-code-confluence-frontend/AGENTS.md`:
- Around line 118-119: In AGENTS.md, update the newly added Architecture section
heading near the architecture.md link so it does not duplicate the earlier
top-level Architecture heading and no longer triggers MD024. Preserve the
architecture.md reference and use a unique, appropriate heading for this
section.

In `@unoplat-code-confluence-frontend/dependencies_overview.md`:
- Line 41: Update the sonner entry in dependencies_overview.md to explicitly
state that the required Sonner <Toaster /> component must be mounted in the app,
replacing the vague “Render in your app” wording while preserving the existing
toast() usage and source links.

In `@unoplat-code-confluence-openmetadata/AGENTS.md`:
- Around line 9-10: Update the Install instruction in AGENTS.md to include the
--locked option in the uv sync command, preserving the existing dev and test
groups and repository-root execution guidance.

---

Outside diff comments:
In `@unoplat-code-confluence-frontend/AGENTS.md`:
- Line 1: Update the architecture document links in the AGENTS.md files for the
frontend, flow bridge, openmetadata, and query-engine components to point to the
repository-root architecture.md using the required relative paths:
../architecture.md for direct subdirectories and ../../architecture.md for the
nested flow-bridge directory.
🪄 Autofix (Beta)

Fix all unresolved CodeRabbit comments on this PR:

  • Push a commit to this branch (recommended)
  • Create a new PR with the fixes

ℹ️ Review info
⚙️ Run configuration

Configuration used: defaults

Review profile: CHILL

Plan: Pro

Run ID: 100f5f73-d53d-48d5-a4d3-e39c0f780c46

📥 Commits

Reviewing files that changed from the base of the PR and between 5ecdba3 and 4bd97a1.

📒 Files selected for processing (24)
  • architecture.md
  • unoplat-code-confluence-cli/AGENTS.md
  • unoplat-code-confluence-cli/business_domain_references.md
  • unoplat-code-confluence-cli/dependencies_overview.md
  • unoplat-code-confluence-commons/AGENTS.md
  • unoplat-code-confluence-commons/business_domain_references.md
  • unoplat-code-confluence-docs/AGENTS.md
  • unoplat-code-confluence-docs/business_domain_references.md
  • unoplat-code-confluence-docs/dependencies_overview.md
  • unoplat-code-confluence-frontend/AGENTS.md
  • unoplat-code-confluence-frontend/app_interfaces.md
  • unoplat-code-confluence-frontend/business_domain_references.md
  • unoplat-code-confluence-frontend/dependencies_overview.md
  • unoplat-code-confluence-ingestion/code-confluence-flow-bridge/AGENTS.md
  • unoplat-code-confluence-ingestion/code-confluence-flow-bridge/app_interfaces.md
  • unoplat-code-confluence-ingestion/code-confluence-flow-bridge/business_domain_references.md
  • unoplat-code-confluence-ingestion/code-confluence-flow-bridge/dependencies_overview.md
  • unoplat-code-confluence-openmetadata/AGENTS.md
  • unoplat-code-confluence-openmetadata/business_domain_references.md
  • unoplat-code-confluence-openmetadata/dependencies_overview.md
  • unoplat-code-confluence-query-engine/AGENTS.md
  • unoplat-code-confluence-query-engine/app_interfaces.md
  • unoplat-code-confluence-query-engine/business_domain_references.md
  • unoplat-code-confluence-query-engine/dependencies_overview.md

Comment on lines +42 to +43
## Architecture
See [`architecture.md`](./architecture.md) for the canonical system architecture diagram.

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

📐 Maintainability & Code Quality | 🟡 Minor | ⚡ Quick win

Correct the nested links to the root architecture document.

Each nested AGENTS.md file currently resolves ./architecture.md within its own directory instead of the repository root.

  • unoplat-code-confluence-cli/AGENTS.md#L42-L43: change the link to ../architecture.md.
  • unoplat-code-confluence-commons/AGENTS.md#L66-L67: change the link to ../architecture.md.
  • unoplat-code-confluence-docs/AGENTS.md#L72-L74: change the link to ../architecture.md.
📍 Affects 3 files
  • unoplat-code-confluence-cli/AGENTS.md#L42-L43 (this comment)
  • unoplat-code-confluence-commons/AGENTS.md#L66-L67
  • unoplat-code-confluence-docs/AGENTS.md#L72-L74
🤖 Prompt for AI Agents
Verify each finding against current code. Fix only still-valid issues, skip the
rest with a brief reason, keep changes minimal, and validate.

In `@unoplat-code-confluence-cli/AGENTS.md` around lines 42 - 43, Update the
Architecture links in unoplat-code-confluence-cli/AGENTS.md lines 42-43,
unoplat-code-confluence-commons/AGENTS.md lines 66-67, and
unoplat-code-confluence-docs/AGENTS.md lines 72-74 from ./architecture.md to
../architecture.md so each points to the repository-root document.

- **click**: Purpose: A Python package for building composable command-line interfaces with minimal code. It provides automatic help-page generation, nested commands, and support for lazy-loaded subcommands.
- **httpx2**: Purpose: A next-generation HTTP client for Python. It provides synchronous and asynchronous APIs, with support for both HTTP/1.1 and HTTP/2. Official docs: https://httpx2.pydantic.dev/ ; PyPI: https://pypi.org/project/httpx2/
- **platformdirs**: Purpose: A Python library for determining platform-specific system directories, such as user data, configuration, cache, and log locations. It resolves the correct paths for macOS, Windows, Linux/Unix, and Android, with `_dir` and `_path` variants for each directory.
- **platformdirs**: Purpose: A Python library for determining platform-specific system directories, such as user data, configuration, cache, and log locations. It resolves the correct paths for macOS, Windows, Linux/Unix, and Android, with _dir and _path variants for each directory.

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

📐 Maintainability & Code Quality | 🟡 Minor | ⚡ Quick win

Keep _dir and _path formatted as code.

The removed backticks cause Markdown emphasis parsing and trigger MD037. Restore inline-code formatting around both API suffixes.

🧰 Tools
🪛 markdownlint-cli2 (0.23.0)

[warning] 6-6: Spaces inside emphasis markers

(MD037, no-space-in-emphasis)

🤖 Prompt for AI Agents
Verify each finding against current code. Fix only still-valid issues, skip the
rest with a brief reason, keep changes minimal, and validate.

In `@unoplat-code-confluence-cli/dependencies_overview.md` at line 6, Restore
inline-code formatting around the _dir and _path API suffixes in the
platformdirs description, using backticks so both identifiers render as code and
avoid Markdown emphasis parsing.

Source: Linters/SAST tools

Comment on lines +118 to +119
## Architecture
See [`architecture.md`](./architecture.md) for the canonical system architecture diagram.

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

📐 Maintainability & Code Quality | 🟡 Minor | ⚡ Quick win

Avoid adding a duplicate top-level Architecture heading.

The frontend guide already defines ## Architecture earlier in the file; this newly added heading triggers MD024. Rename the generated heading or otherwise make the section hierarchy unique.

🧰 Tools
🪛 markdownlint-cli2 (0.23.0)

[warning] 118-118: Multiple headings with the same content

(MD024, no-duplicate-heading)

🤖 Prompt for AI Agents
Verify each finding against current code. Fix only still-valid issues, skip the
rest with a brief reason, keep changes minimal, and validate.

In `@unoplat-code-confluence-frontend/AGENTS.md` around lines 118 - 119, In
AGENTS.md, update the newly added Architecture section heading near the
architecture.md link so it does not duplicate the earlier top-level Architecture
heading and no longer triggers MD024. Preserve the architecture.md reference and
use a unique, appropriate heading for this section.

Source: Linters/SAST tools

- **react-markdown**: Purpose: React component that takes a string of markdown and safely renders it to React elements. Supports remark/rehype plugins and component overrides to customize how markdown is transformed and displayed.
- **shadcn-ui**: Purpose: shadcn/ui is a set of beautifully-designed, accessible components and a code distribution platform. It’s an open-code approach for building your own component library with composable UI primitives and a CLI for distributing components.
- **sonner**: Purpose: An opinionated toast component for React. Render <Toaster /> in your app and call toast() from anywhere to show notifications. Sources: https://sonner.emilkowal.ski/ ; https://github.com/emilkowalski/sonner
- **sonner**: Purpose: An opinionated toast component for React. Render in your app and call toast() from anywhere to show notifications. Sources: https://sonner.emilkowal.ski/ ; https://github.com/emilkowalski/sonner

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

📐 Maintainability & Code Quality | 🟡 Minor | ⚡ Quick win

🧩 Analysis chain

🏁 Script executed:

#!/bin/bash
set -euo pipefail

printf '\n## Relevant repository files\n'
git ls-files 'unoplat-code-confluence-frontend/**/*' | rg '(^|/)(dependencies_overview\.md|package\.json|src/|app/|components/)'

printf '\n## Sonner references in the frontend\n'
rg -n --hidden --glob 'unoplat-code-confluence-frontend/**/*' '\bsonner\b|<Toaster\b|toast\(' unoplat-code-confluence-frontend

printf '\n## dependency overview snippet\n'
sed -n '35,48p' unoplat-code-confluence-frontend/dependencies_overview.md

printf '\n## package manifest if present\n'
if [ -f unoplat-code-confluence-frontend/package.json ]; then
  cat unoplat-code-confluence-frontend/package.json
fi

Repository: unoplat/unoplat-code-confluence

Length of output: 23589


🌐 Web query:

Sonner React documentation Toaster render in your app toast usage

💡 Result:

To use Sonner in a React application, you must install the package and render the Toaster component at the root of your application [1][2][3]. Installation: Install the library using your preferred package manager [2]: npm install sonner # or pnpm add sonner # or yarn add sonner # or bun add sonner Render the Toaster: Add the Toaster component to your application. It acts as the container where all toasts will be rendered [1][4]. You can place it in your root layout (e.g., layout.tsx or App.tsx) [2][3]. import { Toaster } from 'sonner'; export default function RootLayout({ children }) { return (

{children} ); } Usage: Once the Toaster is rendered, you can trigger toasts from anywhere in your application by importing the toast function [1][2]. import { toast } from 'sonner'; function MyComponent { return ( <button onClick={ => toast('This is a toast notification')}> Show Toast ); } The Toaster component supports various configuration props, such as position, richColors, and duration, which can be applied directly to the component to change the behavior of all toasts [5][3].

Citations:


Keep the Sonner setup explicit.

dependencies_overview.md should name the required <Toaster /> mount instead of saying “Render in your app”; that wording is too vague for contributors using Sonner’s setup.

🤖 Prompt for AI Agents
Verify each finding against current code. Fix only still-valid issues, skip the
rest with a brief reason, keep changes minimal, and validate.

In `@unoplat-code-confluence-frontend/dependencies_overview.md` at line 41, Update
the sonner entry in dependencies_overview.md to explicitly state that the
required Sonner <Toaster /> component must be mounted in the app, replacing the
vague “Render in your app” wording while preserving the existing toast() usage
and source links.

Source: Coding guidelines

Comment on lines 9 to +10
### Install
- `uv sync` — run from the repository root using `pyproject.toml`.
- `uv sync --group dev --group test` — run from the repository root using `Taskfile.yml`.

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

📐 Maintainability & Code Quality | 🟡 Minor | ⚡ Quick win

🧩 Analysis chain

🏁 Script executed:

#!/bin/bash
set -euo pipefail

echo "== Files =="
git ls-files | rg '(^|/)AGENTS\.md$|(^|/)Taskfile\.yml$|(^|/)uv\.lock$|(^|/)pyproject\.toml$' || true

echo
echo "== AGENTS.md (top-level and relevant path) =="
for f in $(git ls-files | rg '(^|/)AGENTS\.md$'); do
  echo "--- $f ---"
  wc -l "$f"
done

echo
echo "== Relevant lines from unoplat-code-confluence-openmetadata/AGENTS.md =="
sed -n '1,80p' unoplat-code-confluence-openmetadata/AGENTS.md

echo
echo "== Search for uv sync guidance =="
rg -n --hidden --glob 'AGENTS.md' --glob '!**/.git/**' 'uv sync|locked|group dev|group test|Taskfile' .

Repository: unoplat/unoplat-code-confluence

Length of output: 9934


🏁 Script executed:

#!/bin/bash
set -euo pipefail

echo "== openmetadata Taskfile install task =="
sed -n '1,220p' unoplat-code-confluence-openmetadata/Taskfile.yml

echo
echo "== openmetadata pyproject dependency groups =="
sed -n '1,220p' unoplat-code-confluence-openmetadata/pyproject.toml

echo
echo "== cli AGENTS install line for comparison =="
sed -n '1,40p' unoplat-code-confluence-cli/AGENTS.md

echo
echo "== root AGENTS =="
sed -n '1,120p' AGENTS.md

Repository: unoplat/unoplat-code-confluence

Length of output: 4634


Preserve the locked install flow. Use uv sync --locked --group dev --group test for the install step so setup doesn’t rewrite or drift from uv.lock.

🤖 Prompt for AI Agents
Verify each finding against current code. Fix only still-valid issues, skip the
rest with a brief reason, keep changes minimal, and validate.

In `@unoplat-code-confluence-openmetadata/AGENTS.md` around lines 9 - 10, Update
the Install instruction in AGENTS.md to include the --locked option in the uv
sync command, preserving the existing dev and test groups and repository-root
execution guidance.

Source: Learnings

@JayGhiya
JayGhiya merged commit 3527116 into dev Jul 18, 2026
3 of 4 checks passed
@claude

claude Bot commented Jul 18, 2026

Copy link
Copy Markdown

Claude encountered an error —— View job


I'll analyze this and get back to you.

@github-actions

Copy link
Copy Markdown
Contributor

🚀 Preview Deployment Ready!

Preview URL: https://head.unoplat-code-confluence-docs.pages.dev


Deployed via Cloudflare Pages

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant