Files

T

k1nq 63d065011b Update manifest.json and infra README

- Updated timestamps and AST hashes in manifest.json for various backend and frontend files to reflect recent changes.
- Added new files related to MCC categories and optional hold reasons in the manifest.
- Modified the README in the infra directory to correct the linting tool from 'mypy' to 'ty' for type checking in the backend project.

2026-09-23 10:57:27 +05:00

21 KiB

Raw Blame History

Graph Report - finance (2026-09-23)

Corpus Check

182 files · ~87,581 words
Verdict: corpus is large enough that graph structure adds value.

Summary

1620 nodes · 5066 edges · 89 communities (67 shown, 16 thin omitted)
Extraction: 98% EXTRACTED · 2% INFERRED · 0% AMBIGUOUS · INFERRED: 91 edges (avg confidence: 0.93)
Token cost: 0 input · 0 output

Graph Freshness

Built from commit: db4dd757
Run git rev-parse HEAD and compare to check if the graph is stale.
Run graphify update . after code changes (no API cost).

categorization/service.py
budgeting/router.py
Base
exports/service.py
imports/router.py
alfa_xlsx.py
system-account-picker.test.tsx
types.ts
router.tsx
ledger/router.py
@testing-library/jest-dom
compilerOptions
BudgetPage.tsx
@testing-library/user-event
devDependencies
AppError
dependencies
ImportDetailPage.tsx
OperationsPage.tsx
useOperations.ts
apiErrors.ts
test_adapter_contracts.py
useBudget.ts
client.ts
fields.tsx
Docker Compose Development Stack
Financial Space
scripts
@types/react
General Pool
TestBaseContract
Per-File Envelope Encryption
Operation
Versioned Statement Imports
Finance Frontend SPA
Closed Beta Launch Gates
package.json
Financial Tracker MVP
TestRocketbankDebitContract
generate-api.mjs
schema.d.ts
test_api.py
i18n-parity.test.ts
Expected Income
api
set_space_context
category-manager.test.tsx
graphify
@types/react-dom
typescript-eslint
Ближайший край: накопления, категории и блокировки бюджета
vitest
Favicon SVG (ledger lines icon)
init-app-role.sh
Payee
test_private_fixtures.py
finance-backend
LocalDirectoryBlobStore
OzonDebitPdfAdapter
Gitea CI and real statement imports
20260918_0002_hold_lifecycle.py
eslint-plugin-react-hooks
main.py
analytics/router.py
TestAlfaDebitContract
vite
mcc.py
TestAlfaSavingsRule
savings-convert-revert.test.tsx
exports/router.py
ColumnChart.tsx
identity/service.py
AGENTS.md
Category
test_category_definitions.py
budget-plan.test.tsx
import-hold-resolution.test.tsx
get_settings
session_scope
20260923_0004_mcc_categories.py
Session
app_error_handler
20260923_0005_optional_hold_reason.py

God Nodes (most connected - your core abstractions)

Session - 209 edges
AppError - 72 edges
Base - 48 edges
conflict() - 43 edges
get_settings() - 40 edges
PkMixin - 40 edges
record() - 38 edges
TimestampMixin - 38 edges
StatementDocument - 36 edges
create_expense() - 36 edges

Surprising Connections (you probably didn't know these)

Typed Same-Origin API Client --conceptually_related_to--> Same-Origin Reverse Proxy [INFERRED] frontend/README.md → infra/README.md
Financial Space Ownership --conceptually_related_to--> Financial Space [INFERRED] docs/adr/0001-financial-space-ownership-and-rls.md → CONTEXT.md
Versioned Statement Imports --conceptually_related_to--> Statement Import [INFERRED] docs/adr/0003-versioned-statement-imports.md → CONTEXT.md
MVP Release Gates --conceptually_related_to--> Closed Beta Launch Gates [INFERRED] .kilo/plans/1789034192214-financial-tracker-mvp.md → docs/operations/beta-release-runbook.md
Carry-Over Budget Reserves --references--> Savings Envelope [EXTRACTED] docs/adr/0002-journal-and-budget-reserves.md → CONTEXT.md

Import Cycles

None detected.

Hyperedges (group relationships)

Auditable Financial Model — context_operation, context_posting, docs_adr_0002_journal_and_budget_reserves_derived_balances, docs_adr_0002_journal_and_budget_reserves_plan_funding_separation, docs_adr_0002_journal_and_budget_reserves_closure_snapshots [EXTRACTED 1.00]
Financial Space Tenancy Boundary — context_financial_space, context_membership, docs_adr_0001_financial_space_ownership_and_rls_defense_in_depth_authorization, docs_adr_0001_financial_space_ownership_and_rls_transaction_local_rls, docs_adr_0001_financial_space_ownership_and_rls_cross_space_integrity [EXTRACTED 1.00]
Safe Statement Import Flow — context_statement_import, context_parse_run, context_source_record, docs_adr_0003_versioned_statement_imports_immutable_statement_document, docs_adr_0003_versioned_statement_imports_conservative_deduplication, docs_adr_0003_versioned_statement_imports_atomic_confirm_revert [EXTRACTED 1.00]

Communities (89 total, 16 thin omitted)

Community 0 - "categorization/service.py"

Cohesion: 0.14 Nodes (24): CategorizationRule, CategoryMcc, IncomeSource, MccCode, Payee, PayeeAlias, Space-scoped MCC codes of a category: many codes per category, but every code…, Confirmed payee rule: auto-applies category to matching future operations. (+16 more)

Community 1 - "budgeting/router.py"

Cohesion: 0.17 Nodes (41): AssignmentItem, assignments(), AssignmentsBody, categories(), category_definition_json(), category_definitions(), CategoryBody, CategoryDefinitionPatchBody (+33 more)

Community 2 - "Base"

Cohesion: 0.13 Nodes (33): downgrade(), upgrade(), AuditEvent, Append-only domain/security event. Never stores raw financial payloads., ExpectedIncome, ExpectedIncomeMatch, FundingMovement, PeriodClosure (+25 more)

Community 3 - "exports/service.py"

Cohesion: 0.19 Nodes (17): build_export(), cancel_deletion(), consume_export(), _csv_bytes(), get_export(), _json_rows(), datetime, UUID (+9 more)

Community 4 - "imports/router.py"

Cohesion: 0.15 Nodes (35): confirm(), ConfirmBody, decide_row(), DecisionBody, delete_source(), detail(), HoldResolveBody, imports() (+27 more)

Community 5 - "alfa_xlsx.py"

Cohesion: 0.17 Nodes (24): AlfaDebitXlsxAdapter, _AlfaHeaderMeta, AlfaXlsxAdapterBase, _cell_str(), _debit_find_header(), _debit_header_metadata(), _debit_header_value(), _debit_norm() (+16 more)

Community 6 - "system-account-picker.test.tsx"

Cohesion: 0.15 Nodes (12): AdjustBalanceResult, BudgetCategory, Operation, Page, categoriesMock, importsListMock, importSummary, operationsListMock (+4 more)

Community 7 - "types.ts"

Cohesion: 0.08 Nodes (34): AccountStatus, AccountType, AdjustBalancePayload, BalanceItem, BalancesReport, BudgetStatus, BudgetWarning, CashFlowMonth (+26 more)

Community 8 - "router.tsx"

Cohesion: 0.07 Nodes (53): AcceptInvitePayload, LoginPayload, PasswordResetPayload, AcceptInvitePage, AccountsPage, AnalyticsPage, BudgetPage, ImportDetailPage (+45 more)

Community 9 - "ledger/router.py"

Cohesion: 0.16 Nodes (35): account_json(), AccountBody, accounts(), adjust_balance(), AdjustBalanceBody, archive_account(), create_account(), create_operation() (+27 more)

Community 11 - "compilerOptions"

Cohesion: 0.07 Nodes (28): compilerOptions, baseUrl, esModuleInterop, forceConsistentCasingInFileNames, isolatedModules, jsx, lib, module (+20 more)

Community 12 - "BudgetPage.tsx"

Cohesion: 0.10 Nodes (42): NotFoundPage, PlanFactBars(), PlanFactBarsProps, PlanFactRow, MonthSwitcher(), MonthSwitcherProps, PageHeader(), PageHeaderProps (+34 more)

Community 14 - "devDependencies"

Cohesion: 0.10 Nodes (21): eslint, @eslint/js, eslint-plugin-jsx-a11y, devDependencies, eslint, @eslint/js, eslint-plugin-jsx-a11y, globals (+13 more)

Community 15 - "AppError"

Cohesion: 0.06 Nodes (141): Any, record(), BudgetPeriod, Calendar month budget period in the space timezone (month granularity)., add_expected_income(), archive_category(), _balance_until(), _close_blockers() (+133 more)

Community 16 - "dependencies"

Cohesion: 0.09 Nodes (23): @fontsource/funnel-sans, @fontsource/geist-mono, dependencies, @fontsource/funnel-sans, @fontsource/geist-mono, @hookform/resolvers, i18next, react (+15 more)

Community 17 - "ImportDetailPage.tsx"

Cohesion: 0.16 Nodes (23): HoldResolutionAction, ImportStatus, RowDecision, useToast(), useConfirmImport(), useImport(), useImportErrorToaster(), useReparseImport() (+15 more)

Community 18 - "OperationsPage.tsx"

Cohesion: 0.09 Nodes (54): Account, isSystemAccount(), Locale, Badge(), BadgeTone, EmptyState(), EmptyStateProps, MoneyField() (+46 more)

Community 19 - "useOperations.ts"

Cohesion: 0.15 Nodes (16): invalidationRoots, queryKeys, SESSION_ROOT, sessionInvalidationRoot, SPACE_ROOT, spaceInvalidationRoot, CreateOperationPayload, OperationFilters (+8 more)

Community 20 - "apiErrors.ts"

Cohesion: 0.14 Nodes (16): isApiError(), BudgetBlocker, App(), queryClient, AppRoutes(), blockerCta(), blockerText(), BudgetBlockers() (+8 more)

Community 21 - "test_adapter_contracts.py"

Cohesion: 0.11 Nodes (25): AlfaCreditXlsxAdapter, account_fingerprint(), amount_to_kopecks(), _mask_digits(), money_to_kopecks(), Protocol, Parse statement money strings like '-1 234,56 RUR', '+ 500.00 ₽', '12 345'.…, SourceRow (+17 more)

Community 22 - "useBudget.ts"

Cohesion: 0.22 Nodes (15): CategoryManagerModal(), CREATE_KINDS, CreateCategoryForm(), MccCodesModal(), parseMccCodes(), RenameModal(), ConfirmDialog(), ConfirmDialogProps (+7 more)

Community 23 - "client.ts"

Cohesion: 0.26 Nodes (10): apiClient, ApiError, buildUrl(), ErrorEnvelope, parseErrorEnvelope(), QueryValue, readCsrfToken(), request() (+2 more)

Community 24 - "fields.tsx"

Cohesion: 0.25 Nodes (9): FieldChrome, InputProps, MoneyFieldProps, SelectFieldProps, SelectProps, TextareaField(), TextareaFieldProps, TextareaProps (+1 more)

Community 25 - "Docker Compose Development Stack"

Cohesion: 0.29 Nodes (8): Commodity Infrastructure Services, Docker Compose Development Stack, Internal Backend Network, Same-Origin Frontend Service, Worker Parsing Isolation, Finance Infrastructure, Same-Origin Reverse Proxy, Backend and Frontend Workstream Contracts

Community 26 - "Financial Space"

Cohesion: 0.17 Nodes (12): Credit Reserve, Financial Account, Financial Space, Membership, User, Carry-Over Budget Reserves, Provider-Neutral Data Boundary, Russian Federation Data Residency (+4 more)

Community 27 - "scripts"

Cohesion: 0.22 Nodes (9): scripts, api:generate, build, dev, lint, preview, test, test:watch (+1 more)

Community 29 - "General Pool"

Cohesion: 0.29 Nodes (8): Budget Period, Funding, General Pool, Monthly Category, Plan Assignment, Savings Envelope, Immutable Closure Snapshots, Plan and Funding Separation

Community 30 - "TestBaseContract"

Cohesion: 0.21 Nodes (3): make_draft(), make_source_row(), TestBaseContract

Community 31 - "Per-File Envelope Encryption"

Cohesion: 0.29 Nodes (7): Immutable Statement Document, Per-File Envelope Encryption, Backup and Restore Runbook, Mandatory KEK Backup, Quarterly Restore Drill, Disaster Restore Procedure, Post-Restore Deletion Replay

Community 32 - "Operation"

Cohesion: 0.47 Nodes (6): Internal Transfer, Operation, Posting, Refund, Derived Account Balances, Operations and Postings Journal

Community 33 - "Versioned Statement Imports"

Cohesion: 0.20 Nodes (11): Parse Run, Source Record, Statement Import, Atomic Import Confirm and Revert, Conservative Deduplication, Parser Versioning and Review Diff, Versioned Statement Imports, Layout Drift Re-Gating (+3 more)

Community 34 - "Finance Frontend SPA"

Cohesion: 0.29 Nodes (7): Server-Side Secret Boundary, Grossbukh Application Shell, Accessible Responsive UI, Finance Frontend SPA, RU and EN Localization, Space-Scoped Query Keys, Typed Same-Origin API Client

Community 35 - "Closed Beta Launch Gates"

Cohesion: 0.20 Nodes (11): Crypto-Shredded Deletion, Closed Beta Release Runbook, Forward-Fix Rollback Policy, Financial Data Incident Response, Closed Beta Launch Gates, Production Launch Sequence, Thirty-Day Space Deletion, Durable Deletion Ledger (+3 more)

Community 36 - "package.json"

Cohesion: 0.40 Nodes (4): name, private, type, version

Community 37 - "Financial Tracker MVP"

Cohesion: 0.18 Nodes (11): Audited Break-Glass Access, Cross-Space Referential Integrity, Defense-in-Depth Authorization, Financial Space Ownership, Transaction-Local RLS Context, Budget Invariants, Critical User Path, Financial Tracker MVP (+3 more)

Community 38 - "TestRocketbankDebitContract"

Cohesion: 0.13 Nodes (7): minimal_pdf(), _QuotaSettings, Build a small valid single-font PDF with empty or ASCII-only pages., same_page_rocket_lines(), synthetic_rocket_lines(), TestRocketbankDebitContract, MonkeyPatch

Community 39 - "generate-api.mjs"

Cohesion: 0.40 Nodes (5): firstReadable(), LOCAL_CANDIDATES, main(), OUT_DIR, REMOTE_CANDIDATES

Community 40 - "schema.d.ts"

Cohesion: 0.33 Nodes (5): components, $defs, operations, paths, webhooks

Community 41 - "test_api.py"

Cohesion: 0.67 Nodes (3): TestClient, test_invite_login_and_authenticated_space(), test_openapi_contains_critical_paths()

Community 44 - "api"

Cohesion: 0.11 Nodes (18): api, User, ToastApi, ToastContext, ToastItem, ToastKind, ToastProvider(), adjustBalanceMock (+10 more)

Community 45 - "set_space_context"

Cohesion: 0.26 Nodes (13): _check_constraints(), downgrade(), _has_column(), _has_row(), _has_unique_constraint(), _normalized_sqltext(), Savings system resources, adjustments and reversible conversions., Swap a check constraint for a new value list, dialect-safely. Fresh databases… (+5 more)

Community 46 - "category-manager.test.tsx"

Cohesion: 0.15 Nodes (11): CategoryDefinition, categoriesMock, createCategoryMock, definitions, definitionsMock, diningDefinition, month, monthCategories (+3 more)

Community 47 - "graphify"

Cohesion: 0.17 Nodes (11): command, enabled, timeout, type, mcp, graphify, plugin, $schema (+3 more)

Community 50 - "Ближайший край: накопления, категории и блокировки бюджета"

Cohesion: 0.10 Nodes (20): 1. Доменная основа накоплений, 2. Альфа debit: «Копилка для сдачи», 3. Управление категориями, 4. Понятные и устранимые блокировки, Backend-контракт, Frontend, Ближайший край: накопления, категории и блокировки бюджета, Бюджетная семантика (+12 more)

Community 58 - "test_private_fixtures.py"

Cohesion: 0.12 Nodes (22): detect_adapter(), Any, Reconcile parsed rows against declared bank controls with stable diagnostics.…, _reconciliation_summary(), _check(), _fail(), _load_entries(), parsed() (+14 more)

Community 62 - "LocalDirectoryBlobStore"

Cohesion: 0.39 Nodes (3): LocalDirectoryBlobStore, Path, S3-neutral local store; production swaps in an S3-compatible client.

Community 63 - "OzonDebitPdfAdapter"

Cohesion: 0.16 Nodes (7): _ozon_cell(), _ozon_normalize(), OzonDebitPdfAdapter, Ozon debit statement contract, evidenced against the real document. A 'Справка…, ozon_extracted(), TestOzonDebitContract, Pattern

Community 64 - "Gitea CI and real statement imports"

Cohesion: 0.29 Nodes (6): Confirmed decisions, Gitea CI and real statement imports, Goal and constraints, Implementation plan, Principal risks, Validation and rollout

Community 65 - "20260918_0002_hold_lifecycle.py"

Cohesion: 0.80 Nodes (4): downgrade(), _has_check_constraint(), _has_column(), upgrade()

Community 67 - "main.py"

Cohesion: 0.31 Nodes (9): get_db(), get_engine(), get_session_factory(), sessionmaker, health(), healthz(), get, readiness() (+1 more)

Community 68 - "analytics/router.py"

Cohesion: 0.24 Nodes (14): balances(), cash_flow(), category_spend(), plan_fact(), Context, date, Db, get (+6 more)

Community 69 - "TestAlfaDebitContract"

Cohesion: 0.18 Nodes (3): alfa_workbook_bytes(), synthetic_alfa_rows(), TestAlfaDebitContract

Community 71 - "mcc.py"

Cohesion: 0.24 Nodes (12): _default_categories(), DefaultCategory, english_title(), _english_titles(), iter_mcc_dictionary(), MCC catalog backed by the iso18245 library with Russian labels. The global…, Curated Russian translation, else a Cyrillic transcription of the label., Yield (code, russian_title) for every MCC known to iso18245. (+4 more)

Community 73 - "savings-convert-revert.test.tsx"

Cohesion: 0.20 Nodes (6): budgetCategoriesMock, listAccountsMock, listOperationsMock, operations, revertMock, savingsTransferMock

Community 74 - "exports/router.py"

Cohesion: 0.27 Nodes (10): download(), export_status(), Context, Csrf, Db, get, post, Response (+2 more)

Community 75 - "ColumnChart.tsx"

Cohesion: 0.24 Nodes (7): CashFlowColumn, ColumnChart(), ColumnChartProps, BarRow, HorizontalBars(), HorizontalBarsProps, rows

Community 76 - "identity/service.py"

Cohesion: 0.06 Nodes (80): current_context(), current_session(), alias, Context, CurrentSession, Db, Header, User (+72 more)

Community 79 - "Category"

Cohesion: 0.23 Nodes (12): Pure localization key for system categories; None for user categories., resolve_category_name_key(), Account, Category, Operation, Budget category. Kept in ledger module to avoid circular imports., Financial account. Balance is always derived: opening + confirmed postings., User financial fact. amount_kopecks is always positive; direction lives in… (+4 more)

Community 80 - "test_category_definitions.py"

Cohesion: 0.50 Nodes (8): bootstrap(), TestClient, HTTP contract for category definitions, system protections and CSRF., test_adjust_and_savings_conversion_http_contracts(), test_categories_expose_and_update_multiple_mcc_codes(), test_category_lifecycle_create_rename_archive_restore(), test_openapi_contains_new_contracts(), test_space_has_protected_savings_pair()

Community 81 - "budget-plan.test.tsx"

Cohesion: 0.25 Nodes (7): BudgetSummary, categories, categoriesMock, month, summary, summaryMock, updatePlanMock

Community 82 - "import-hold-resolution.test.tsx"

Cohesion: 0.15 Nodes (11): ImportDetail, ImportRow, ImportSummary, confirmMock, detailFixture(), getImportMock, postedRow(), getImportMock (+3 more)

Community 83 - "get_settings"

Cohesion: 0.10 Nodes (12): get_settings(), Settings, send_token_email(), BlobStore, get_blob_store(), Protocol, S3BlobStore, create_celery_app() (+4 more)

Community 84 - "session_scope"

Cohesion: 0.31 Nodes (9): Any, Transactional scope for workers/endpoints that own the transaction lifecycle., session_scope(), purge_due_spaces(), build_export_task(), enqueue_export(), purge_due_spaces_task(), task (+1 more)

Community 85 - "20260923_0004_mcc_categories.py"

Cohesion: 0.46 Nodes (7): _create_tenant_policy(), _default_keys(), downgrade(), _has_table(), _space_ids(), upgrade(), default_category_system_keys()

Community 86 - "Session"

Cohesion: 0.06 Nodes (124): datetime, utcnow(), Session, detect_savings_transfer(), _savings_rule_text(), normalize_description(), date, record_fingerprint() (+116 more)

Community 87 - "app_error_handler"

Cohesion: 0.32 Nodes (8): app_error_handler(), Request, security_headers(), stale_data_handler(), exception_handler, JSONResponse, middleware, StaleDataError

Community 88 - "20260923_0005_optional_hold_reason.py"

Cohesion: 0.83 Nodes (3): downgrade(), _reason_constraint_name(), upgrade()

Knowledge Gaps

250 isolated node(s): $schema, file:///home/k1nq/repos/finance/.kilo/plugins/graphify.js, type, /home/k1nq/.local/bin/graphify-mcp, /home/k1nq/repos/finance/graphify-out/graph.json (+245 more) These have ≤1 connection - possible missing edges or undocumented components. (Counts symbols only; 443 node(s) total have ≤1 connection when file, concept and rationale nodes are included.)
16 thin communities (<3 nodes) omitted from report — run graphify query to explore isolated nodes.

21 KiB Raw Blame History