{ "$schema": "https://ui.shadcn.com/schema/registry-item.json", "name": "billing-reconciliation", "type": "registry:block", "title": "Billing Reconciliation", "description": "Provider/database drift checks and reconciliation job status.", "dependencies": [], "devDependencies": [], "registryDependencies": [ "https://stackfoundry.dev/r/billing-core.json", "https://stackfoundry.dev/r/background-jobs.json" ], "files": [ { "path": "packages/db/src/schema/billing-reconciliation.ts", "type": "registry:file", "target": "packages/db/src/schema/billing-reconciliation.ts", "content": "import { index, jsonb, pgTable, text, timestamp, uuid } from \"drizzle-orm/pg-core\";\n\nexport const billingReconciliation = pgTable(\n \"billing_reconciliation\",\n {\n id: uuid(\"id\").primaryKey().defaultRandom(),\n organizationId: text(\"organization_id\"),\n ownerId: text(\"owner_id\"),\n key: text(\"key\").notNull(),\n status: text(\"status\").notNull().default(\"active\"),\n metadata: jsonb(\"metadata\").$type>().notNull().default({}),\n createdAt: timestamp(\"created_at\", { withTimezone: true }).defaultNow().notNull(),\n updatedAt: timestamp(\"updated_at\", { withTimezone: true }).defaultNow().notNull(),\n },\n (item) => [\n index(\"billing_reconciliation_organization_idx\").on(item.organizationId),\n index(\"billing_reconciliation_owner_idx\").on(item.ownerId),\n ]\n);\n" }, { "path": "apps/web/src/lib/stackfoundry/billing-reconciliation.ts", "type": "registry:file", "target": "apps/web/src/lib/stackfoundry/billing-reconciliation.ts", "content": "export type BillingReconciliationConfig = {\n key: string;\n enabled?: boolean;\n metadata?: Record;\n};\n\nexport function createBillingReconciliationConfig(config: BillingReconciliationConfig) {\n return {\n key: config.key,\n enabled: config.enabled ?? true,\n metadata: config.metadata ?? {},\n };\n}\n\nexport const billingReconciliationChecks = [\n \"Validate tenant and permission boundaries\",\n \"Record audit events for sensitive changes\",\n \"Document deployment and rollback behavior\",\n] as const;\n" }, { "path": "apps/web/src/app/(console)/billing/reconciliation/page.tsx", "type": "registry:page", "target": "apps/web/src/app/(console)/billing/reconciliation/page.tsx", "content": "const checklist = [\n \"Confirm ownership boundaries\",\n \"Wire persistence and authorization\",\n \"Run smoke checks before production\",\n];\n\nexport default function BillingReconciliationPage() {\n return (\n
\n
\n

Billing Reconciliation

\n

Provider/database drift checks and reconciliation job status.

\n
\n
\n {checklist.map((item) => (\n
{item}
\n ))}\n
\n
\n );\n}\n" } ], "maintenanceSkills": [ { "name": "billing-reconciliation", "target": ".stackfoundry/skills/billing-reconciliation/SKILL.md", "content": "---\nname: billing-reconciliation\ndescription: Maintain the Billing Reconciliation module installed by StackFoundry.\n---\n\n# Billing Reconciliation Skill\n\n## Boundary\n\nThis module owns the Billing Reconciliation source block and its safety checklist. Keep business-specific behavior outside the reusable block until an app adopts it.\n\n## Shared Skills\n\nWhen provider, framework, or database behavior changes, load the installed shared skill before editing implementation details:\n\n- `.stackfoundry/skills/nextjs/SKILL.md` (source: `registry/skills/nextjs/SKILL.md`)\n- `.stackfoundry/skills/drizzle/SKILL.md` (source: `registry/skills/drizzle/SKILL.md`)\n\nKeep this module skill focused on ownership, installed files, env vars, deployment checks, and module-specific invariants.\n\n## Source Files\n\n- `packages/db/src/schema/billing-reconciliation.ts`\n- `apps/web/src/lib/stackfoundry/billing-reconciliation.ts`\n- `apps/web/src/app/(console)/billing/reconciliation/page.tsx`\n\n## Dependencies\n\n- Depends on `billing-core`\n- Depends on `background-jobs`\n\n## Maintenance Rules\n\n- Preserve tenant, permission, and data-safety boundaries.\n- Keep examples small, typed, and replaceable.\n- Update docs and checklist with behavior changes.\n- Do not add secrets, credentials, or generated machine metadata.\n" }, { "name": "nextjs", "target": ".stackfoundry/skills/nextjs/SKILL.md", "content": "---\nname: nextjs\ndescription: Maintain Next.js App Router code installed by StackFoundry modules.\n---\n\n# Next.js Operating Instructions\n\n## Installed Location\n\n- Installed target: `.stackfoundry/skills/nextjs/SKILL.md`\n- Registry source: `registry/skills/nextjs/SKILL.md`\n\nAgents maintaining an installed module should load this shared skill from the installed target when provider, framework, database, SDK, or platform behavior is involved. Keep provider-specific API details here instead of duplicating them inside module maintenance skills.\n\n- Keep server-only data access out of Client Components.\n- Put route handlers under `app/api` and UI routes under the relevant App Router segment.\n- Prefer Server Components for data loading and add `\"use client\"` only for interactivity.\n- Keep public environment variables prefixed with `NEXT_PUBLIC_`; keep secrets server-only.\n- Re-run typecheck and build after changing route handlers, layouts, or shared app configuration.\n" }, { "name": "drizzle", "target": ".stackfoundry/skills/drizzle/SKILL.md", "content": "---\nname: drizzle\ndescription: Maintain Drizzle ORM and Postgres code installed by StackFoundry modules.\n---\n\n# Drizzle Operating Instructions\n\n## Installed Location\n\n- Installed target: `.stackfoundry/skills/drizzle/SKILL.md`\n- Registry source: `registry/skills/drizzle/SKILL.md`\n\nAgents maintaining an installed module should load this shared skill from the installed target when provider, framework, database, SDK, or platform behavior is involved. Keep provider-specific API details here instead of duplicating them inside module maintenance skills.\n\n- Keep database access in server-only code.\n- Add schema changes under `packages/db/src/schema` and export shared tables from the schema barrel.\n- Generate and commit migrations when schema changes are intended.\n- Use typed query helpers instead of raw SQL unless the query needs a documented escape hatch.\n- Include tenant, organization, or user scope in queries and cache tags whenever data is not global.\n" } ], "envVars": {}, "docs": "# Billing Reconciliation Module\n\nProvider/database drift checks and reconciliation job status.\n\n## Owns\n\n- `packages/db/src/schema/billing-reconciliation.ts`\n- `apps/web/src/lib/stackfoundry/billing-reconciliation.ts`\n- `apps/web/src/app/(console)/billing/reconciliation/page.tsx`\n\n## Safety Notes\n\n- Keep tenant, permission, and billing boundaries explicit.\n- Validate all server inputs before side effects.\n- Record audit events for sensitive state changes.\n- Do not commit secrets, credentials, local caches, or provider tokens.\n\n## Maintenance\n\n- Update `module.json`, `docs.md`, `skill/SKILL.md`, and `tests/checklist.md` together.\n- Verify install output with `pnpm stackfoundry add billing-reconciliation --target /tmp/app --dry-run`.\n", "meta": { "category": "billing", "env": [], "status": "ready", "maturity": "ready", "drizzle": { "schemaExports": [ "billingReconciliation" ], "migrationRecommended": true }, "recommendedFor": [] } }