internal/

directory
v0.0.0-...-10ede12 Latest Latest
Warning

This package is not in the latest version of its module.

Go to latest
Published: Nov 19, 2026 License: AGPL-3.0

Directories

Path Synopsis
Package acl is the single source of truth for nodate-flow access control checks.
Package acl is the single source of truth for nodate-flow access control checks.
ai
Package ai — agent attribution context key.
Package ai — agent attribution context key.
agentguard
Package agentguard implements the cost / scope guard for AI agents.
Package agentguard implements the cost / scope guard for AI agents.
agentruntime
Package agentruntime hosts the lightweight in-process scheduler that fires AI agents on cron / on-event / manual triggers.
Package agentruntime hosts the lightweight in-process scheduler that fires AI agents on cron / on-event / manual triggers.
airequest
Package airequest is the single builder for providers.Request.
Package airequest is the single builder for providers.Request.
autoactions
Package autoactions implements the "auto actions" stream.
Package autoactions implements the "auto actions" stream.
commitmsg
Package commitmsg implements the "commit message proposal" stream Given a compact view of a change set — file paths, their status (added / modified / deleted), and an optional summary — it proposes a Conventional Commits message (type(scope): subject).
Package commitmsg implements the "commit message proposal" stream Given a compact view of a change set — file paths, their status (added / modified / deleted), and an optional summary — it proposes a Conventional Commits message (type(scope): subject).
digest
Package digest implements the "weekly digest" stream Given a slice of task snapshots for a workspace, it produces a deterministic markdown summary: counts by state, tasks completed in the last 7 days, and overdue open tasks.
Package digest implements the "weekly digest" stream Given a slice of task snapshots for a workspace, it produces a deterministic markdown summary: counts by state, tasks completed in the last 7 days, and overdue open tasks.
duedate
Package duedate compares a task's due_on to "today" for the deterministic AI evaluators (reminders, stateinfer, autoactions, priorityopt, digest), so all of them agree on when a task is due today and when it is overdue.
Package duedate compares a task's due_on to "today" for the deterministic AI evaluators (reminders, stateinfer, autoactions, priorityopt, digest), so all of them agree on when a task is due today and when it is overdue.
embed
Package embed provides the task embedding client used by the duplicate-detection pipeline.
Package embed provides the task embedding client used by the duplicate-detection pipeline.
inboxtriage
Package inboxtriage implements the deterministic path for the "inbox triage" stream.
Package inboxtriage implements the deterministic path for the "inbox triage" stream.
judge
Package judge is the scaffold for the "LLM-as-judge" test harness It gives the rest of the AI test suite a single place to describe quality expectations for a model output — required phrases, required JSON keys, a score floor — and evaluate a candidate answer against them without pulling in a live LLM provider.
Package judge is the scaffold for the "LLM-as-judge" test harness It gives the rest of the AI test suite a single place to describe quality expectations for a model output — required phrases, required JSON keys, a score floor — and evaluate a candidate answer against them without pulling in a live LLM provider.
nlcommand
Package nlcommand cache.go provides a short-lived in-memory cache for resolved NL commands.
Package nlcommand cache.go provides a short-lived in-memory cache for resolved NL commands.
nlconstraint
Package nlconstraint compiles natural-language prose into a validated constraint DSL expression.
Package nlconstraint compiles natural-language prose into a validated constraint DSL expression.
nlquery
Package nlquery implements the NL query → Lens JSON compiler.
Package nlquery implements the NL query → Lens JSON compiler.
outputcontract
Package outputcontract validates model output against static, server-owned JSON Schema contracts carried by providers.Request.
Package outputcontract validates model output against static, server-owned JSON Schema contracts carried by providers.Request.
priorityopt
Package priorityopt implements the "priority optimization" stream Given a compact view of a workspace's open tasks, it proposes a suggested priority in [0, 4] for each task so humans can triage the backlog against a single consistent ranking.
Package priorityopt implements the "priority optimization" stream Given a compact view of a workspace's open tasks, it proposes a suggested priority in [0, 4] for each task so humans can triage the backlog against a single consistent ranking.
providers
Package providers contains the LLM provider abstraction (Anthropic / OpenAI / Google / Ollama / OpenAI-compatible) and is the ONLY package outside go-shared/crypto allowed to import go-shared/crypto.
Package providers contains the LLM provider abstraction (Anthropic / OpenAI / Google / Ollama / OpenAI-compatible) and is the ONLY package outside go-shared/crypto allowed to import go-shared/crypto.
relations
Package relations implements the background AI pipeline that auto-detects candidate task relationships by embedding similarity.
Package relations implements the background AI pipeline that auto-detects candidate task relationships by embedding similarity.
reminders
Package reminders implements the "reminder engine" stream Given a compact view of a task's timing signals (current state, due date, now), it emits at most one reminder of a fixed kind.
Package reminders implements the "reminder engine" stream Given a compact view of a task's timing signals (current state, due date, now), it emits at most one reminder of a fixed kind.
safety
Package safety provides heuristic scanners that detect PII and secrets in user-generated content before it is exposed publicly.
Package safety provides heuristic scanners that detect PII and secrets in user-generated content before it is exposed publicly.
signaljudge
Package signaljudge — Applier translates a judge verdict into task-domain events.
Package signaljudge — Applier translates a judge verdict into task-domain events.
stateinfer
Package stateinfer implements the "state inference" stream Given a compact view of a task's signals (current derived state, staleness, dependency count, due date), it proposes the next likely state machine transition.
Package stateinfer implements the "state inference" stream Given a compact view of a task's signals (current derived state, staleness, dependency count, due date), it proposes the next likely state machine transition.
Package audit provides a thin helper for appending workspace-scoped audit log entries via the sqlc-generated AppendAuditLog query.
Package audit provides a thin helper for appending workspace-scoped audit log entries via the sqlc-generated AppendAuditLog query.
Package auth contains password hashing, JWT, opaque token, and OIDC helpers used by the HTTP authentication pipeline.
Package auth contains password hashing, JWT, opaque token, and OIDC helpers used by the HTTP authentication pipeline.
sessadapter
Package sessadapter bridges flow-api's sqlc-generated session queries to the shared sessionstore.SessionQueries interface.
Package sessadapter bridges flow-api's sqlc-generated session queries to the shared sessionstore.SessionQueries interface.
Package bgloop supervises the long-running loops this binary starts in the background: the agent scheduler and workers, the agent_runs purger, the webhook delivery worker, the auto-action executor and the item-consistency reconciler.
Package bgloop supervises the long-running loops this binary starts in the background: the agent scheduler and workers, the agent_runs purger, the webhook delivery worker, the auto-action executor and the item-consistency reconciler.
Package calendaroccurrence holds the machinery for acting on part of a recurring calendar series rather than the whole of it, in the one place every transport that offers the choice goes through: the REST handlers under internal/http/handlers/calendars and the calendar tools in internal/mcp.
Package calendaroccurrence holds the machinery for acting on part of a recurring calendar series rather than the whole of it, in the one place every transport that offers the choice goes through: the REST handlers under internal/http/handlers/calendars and the calendar tools in internal/mcp.
Package calendarrules holds the input preconditions a calendar_events write has to pass, in the one place every transport that performs one goes through: the REST handlers under internal/http/handlers/calendars and the calendar tools in internal/mcp.
Package calendarrules holds the input preconditions a calendar_events write has to pass, in the one place every transport that performs one goes through: the REST handlers under internal/http/handlers/calendars and the calendar tools in internal/mcp.
Package config loads runtime configuration from NF_* environment variables.
Package config loads runtime configuration from NF_* environment variables.
Package constraint implements the constraint DSL: a JSON-structured, side-effect-free expression language that any task_constraints row can embed in its `expression` column.
Package constraint implements the constraint DSL: a JSON-structured, side-effect-free expression language that any task_constraints row can embed in its `expression` column.
engine
Package engine is the differential constraint evaluator.
Package engine is the differential constraint evaluator.
db
dbretry
Package dbretry re-exports the shared retry policy and commit-boundary types from packages/go-shared/dbretry under flow-api's own import path.
Package dbretry re-exports the shared retry policy and commit-boundary types from packages/go-shared/dbretry under flow-api's own import path.
types
Package types re-exports the shared PublicID type so that sqlc-generated code continues to compile without changes to sqlc.yaml overrides.
Package types re-exports the shared PublicID type so that sqlc-generated code continues to compile without changes to sqlc.yaml overrides.
Package dto defines API boundary types shared by Huma operations.
Package dto defines API boundary types shared by Huma operations.
Package eventbus provides a thin helper for appending rows to the append-only events table.
Package eventbus provides a thin helper for appending rows to the append-only events table.
Package execution holds immutable authorization principals and the transaction-current task authorization used by taskservice commands.
Package execution holds immutable authorization principals and the transaction-current task authorization used by taskservice commands.
http
blobs
Package blobs relays object bytes between the browser and object storage.
Package blobs relays object bytes between the browser and object storage.
errormodel
Package errormodel installs the request-validation error model the service answers with.
Package errormodel installs the request-validation error model the service answers with.
handlers/activity
Package activity contains the Huma operation handler for the unified workspace activity feed (GET /workspaces/{wsId}/activity).
Package activity contains the Huma operation handler for the unified workspace activity feed (GET /workspaces/{wsId}/activity).
handlers/ai
Package ai — metrics.go exposes workspace-scoped AI suggestion acceptance metrics.
Package ai — metrics.go exposes workspace-scoped AI suggestion acceptance metrics.
handlers/audit
Package audit contains Huma operation handlers for reading the workspace audit log.
Package audit contains Huma operation handlers for reading the workspace audit log.
handlers/dashboard
Package dashboard contains Huma operation handlers for the /workspaces/{wsId}/dashboard/widgets endpoints (widget CRUD, position updates, soft-delete).
Package dashboard contains Huma operation handlers for the /workspaces/{wsId}/dashboard/widgets endpoints (widget CRUD, position updates, soft-delete).
handlers/events
Package events contains Huma operation handlers for the /workspaces/{wsId}/events/* endpoints.
Package events contains Huma operation handlers for the /workspaces/{wsId}/events/* endpoints.
handlers/export
Package export contains Huma operation handlers for the /workspaces/{wsId}/export endpoints (task data export).
Package export contains Huma operation handlers for the /workspaces/{wsId}/export endpoints (task data export).
handlers/favorites
Package favorites contains Huma operation handlers for user-scoped favorite CRUD (/me/favorites).
Package favorites contains Huma operation handlers for user-scoped favorite CRUD (/me/favorites).
handlers/handlerutil
Package handlerutil — keyset cursor encoding helpers.
Package handlerutil — keyset cursor encoding helpers.
handlers/imports
Package imports contains Huma operation handlers for workspace-scoped import job CRUD (/workspaces/{wsId}/imports).
Package imports contains Huma operation handlers for workspace-scoped import job CRUD (/workspaces/{wsId}/imports).
handlers/inbox
Package inbox - suggestions_list.go exposes the persisted AI suggestion lifecycle so the Glass Dock can resume across devices.
Package inbox - suggestions_list.go exposes the persisted AI suggestion lifecycle so the Glass Dock can resume across devices.
handlers/intake
Package intake contains Huma operation handlers for workspace-scoped intake triage queue CRUD (/workspaces/{wsId}/intake).
Package intake contains Huma operation handlers for workspace-scoped intake triage queue CRUD (/workspaces/{wsId}/intake).
handlers/integrationmappings
Package integrationmappings contains Huma operation handlers for the workspace-scoped CRUD over integration_source_mappings — the table the /webhooks/* receivers consult to decide which tenant an inbound delivery belongs to.
Package integrationmappings contains Huma operation handlers for the workspace-scoped CRUD over integration_source_mappings — the table the /webhooks/* receivers consult to decide which tenant an inbound delivery belongs to.
handlers/internalapi
Package internalapi exposes service-token-only endpoints under the /internal/* path prefix.
Package internalapi exposes service-token-only endpoints under the /internal/* path prefix.
handlers/labels
Package labels contains Huma operation handlers for workspace-scoped label CRUD and task-label association.
Package labels contains Huma operation handlers for workspace-scoped label CRUD and task-label association.
handlers/lenses
Package lenses contains Huma operation handlers for the /workspaces/{wsId}/lenses endpoints (saved view CRUD).
Package lenses contains Huma operation handlers for the /workspaces/{wsId}/lenses endpoints (saved view CRUD).
handlers/notifications
Package notifications contains Huma operation handlers for the notification endpoints (list, count-unread, mark-read, mark-all-read, archive).
Package notifications contains Huma operation handlers for the notification endpoints (list, count-unread, mark-read, mark-all-read, archive).
handlers/pages
Package pages contains Huma operation handlers for the /workspaces/{wsId}/pages endpoints (wiki / documentation page CRUD, hierarchy management, search, and AI generation).
Package pages contains Huma operation handlers for the /workspaces/{wsId}/pages endpoints (wiki / documentation page CRUD, hierarchy management, search, and AI generation).
handlers/projects
Package projects contains Huma operation handlers for the /workspaces/{wsId}/projects and /projects/{prjId} endpoints.
Package projects contains Huma operation handlers for the /workspaces/{wsId}/projects and /projects/{prjId} endpoints.
handlers/reactions
Package reactions contains Huma operation handlers for task-scoped reaction CRUD.
Package reactions contains Huma operation handlers for task-scoped reaction CRUD.
handlers/relations
Package relations contains Huma operation handlers for the relation suggestion endpoints (list for workspace, list for task, resolve).
Package relations contains Huma operation handlers for the relation suggestion endpoints (list for workspace, list for task, resolve).
handlers/signals
Package signals — subject normalisation helpers shared by the manual ingestion handler (POST /signals) and the provider webhook adapters (GitHub / Slack / Google).
Package signals — subject normalisation helpers shared by the manual ingestion handler (POST /signals) and the provider webhook adapters (GitHub / Slack / Google).
handlers/tasks
Package tasks — ai_invocations.go exposes the per-task AI reasoning panel feed.
Package tasks — ai_invocations.go exposes the per-task AI reasoning panel feed.
handlers/taskworkflow
Package taskworkflow contains review-gated task completion and accepted human responsibility handoffs.
Package taskworkflow contains review-gated task completion and accepted human responsibility handoffs.
handlers/timeboxes
Package timeboxes contains Huma operation handlers for the /workspaces/{wsId}/timeboxes endpoints (timebox / sprint CRUD, task association, status transitions).
Package timeboxes contains Huma operation handlers for the /workspaces/{wsId}/timeboxes endpoints (timebox / sprint CRUD, task association, status transitions).
handlers/timeline
Package timeline contains Huma operation handlers for the /tasks/{id}/timeline, /projects/{prjId}/timeline and /workspaces/{wsId}/timeline endpoints.
Package timeline contains Huma operation handlers for the /tasks/{id}/timeline, /projects/{prjId}/timeline and /workspaces/{wsId}/timeline endpoints.
handlers/webhooks
Package webhooks contains Huma operation handlers for webhook subscription management and delivery log inspection.
Package webhooks contains Huma operation handlers for webhook subscription management and delivery log inspection.
middleware
Package middleware contains chi-compatible HTTP middlewares for the nodate-flow API, including authentication and ACL (access control list) enforcement.
Package middleware contains chi-compatible HTTP middlewares for the nodate-flow API, including authentication and ACL (access control list) enforcement.
router
Package router assembles the nodate-flow HTTP API router.
Package router assembles the nodate-flow HTTP API router.
Package importer runs the queued import jobs that POST /workspaces/{wsId}/imports enqueues.
Package importer runs the queued import jobs that POST /workspaces/{wsId}/imports enqueues.
Package inboxsnapshot defines the bounded, actor-authorized input shared by AI triage and suggestion execution.
Package inboxsnapshot defines the bounded, actor-authorized input shared by AI triage and suggestion execution.
integrations
github
Package github contains helpers for verifying inbound GitHub webhook requests.
Package github contains helpers for verifying inbound GitHub webhook requests.
google
Package google contains helpers for ingesting Google Drive / Docs push notifications.
Package google contains helpers for ingesting Google Drive / Docs push notifications.
slack
Package slack contains helpers for verifying inbound Slack webhook requests using the v0 signing-secret scheme:
Package slack contains helpers for verifying inbound Slack webhook requests using the v0 signing-secret scheme:
Package itemkit is the sole writer for cross-table mutations that span tasks and calendar_events.
Package itemkit is the sole writer for cross-table mutations that span tasks and calendar_events.
Package lifecycle coordinates graceful shutdown of the flow-api process.
Package lifecycle coordinates graceful shutdown of the flow-api process.
Package log wires the project's structured logger (log/slog) together with a redaction handler that scrubs secret-looking values before they reach the underlying writer.
Package log wires the project's structured logger (log/slog) together with a redaction handler that scrubs secret-looking values before they reach the underlying writer.
Package mcp ACL helpers.
Package mcp ACL helpers.
Package mentions keeps the mentions table in step with the body each mention was written in.
Package mentions keeps the mentions table in step with the body each mention was written in.
Package mutationlog records one workspace-visible change in the two places such a change has to appear: a row in `events`, which drives the timeline, notifications, webhooks and the live SSE feeds, and a row in `audit_logs`, which is what an administrator queries by action name when they need to know who did what.
Package mutationlog records one workspace-visible change in the two places such a change has to appear: a row in `events`, which drives the timeline, notifications, webhooks and the live SSE feeds, and a row in `audit_logs`, which is what an administrator queries by action name when they need to know who did what.
mutationguard
Package mutationguard is the static half of the mutation log.
Package mutationguard is the static half of the mutation log.
Package notification implements the notification fan-out service that subscribes to eventbus events and creates per-user notification rows for workspace members.
Package notification implements the notification fan-out service that subscribes to eventbus events and creates per-user notification rows for workspace members.
prefs
Package prefs holds the notification preference vocabulary — the configurable event categories, the delivery channels, and the rule that resolves a user's stored rows into the channels a notification is actually written to.
Package prefs holds the notification preference vocabulary — the configurable event categories, the delivery channels, and the rule that resolves a user's stored rows into the channels a notification is actually written to.
Package notifications provides a lightweight background scheduler that checks for upcoming calendar events with notification offsets and dispatches reminder notifications through the shared notification.Fanout so they land in the same in-app notification store as task / comment / item events.
Package notifications provides a lightweight background scheduler that checks for upcoming calendar events with notification offsets and dispatches reminder notifications through the shared notification.Fanout so they land in the same in-app notification store as task / comment / item events.
Package obs provides OpenTelemetry tracing and observability helpers for the nodate-flow API server.
Package obs provides OpenTelemetry tracing and observability helpers for the nodate-flow API server.
Package operation stores transaction-scoped idempotency receipts shared by command endpoints.
Package operation stores transaction-scoped idempotency receipts shared by command endpoints.
Package outbound provides primitives for making egress calls to external services (GitHub / Slack / Google / LLM providers) with uniform rate limiting, so a buggy agent can't flood a third party.
Package outbound provides primitives for making egress calls to external services (GitHub / Slack / Google / LLM providers) with uniform rate limiting, so a buggy agent can't flood a third party.
Package reconciler contains background drift-healing loops that keep tasks and calendar_events consistent when a writer bypassed itemkit (e.g.
Package reconciler contains background drift-healing loops that keep tasks and calendar_events consistent when a writer bypassed itemkit (e.g.
Package sessionguard arms and disarms the MySQL session variables that let an engine write through a guard trigger.
Package sessionguard arms and disarms the MySQL session variables that let an engine write through a guard trigger.
Package signalkinds enumerates the closed set of signal kinds the system observes and routes to the judge.
Package signalkinds enumerates the closed set of signal kinds the system observes and routes to the judge.
Package sourceintake projects authenticated signal payloads into bounded, plain-text fields suitable for review in Inbox and Intake.
Package sourceintake projects authenticated signal payloads into bounded, plain-text fields suitable for review in Inbox and Intake.
Package storage wraps an S3-compatible object store (MinIO / AWS S3).
Package storage wraps an S3-compatible object store (MinIO / AWS S3).
Package storagegc reclaims object-storage rows and the blobs behind them.
Package storagegc reclaims object-storage rows and the blobs behind them.
Package stream implements the realtime SSE fan-out described here.
Package stream implements the realtime SSE fan-out described here.
Package suggestioncommand implements atomic, workspace-scoped commands for persisted AI inbox suggestions.
Package suggestioncommand implements atomic, workspace-scoped commands for persisted AI inbox suggestions.
Package suggestionprivacy stores and authorizes the task references that informed actor-private AI suggestion batches.
Package suggestionprivacy stores and authorizes the task references that informed actor-private AI suggestion batches.
Package taskcreate is the single writer for new rows in tasks.
Package taskcreate is the single writer for new rows in tasks.
Package taskdeps owns the one way a task_dependencies edge is written.
Package taskdeps owns the one way a task_dependencies edge is written.
Package taskdesc is the single writer for rows in task_description_versions.
Package taskdesc is the single writer for rows in task_description_versions.
Package taskrules holds the input preconditions a tasks write has to pass, in one place every transport that performs one can reach: the REST handlers under internal/http/handlers/tasks and the task tools in internal/mcp.
Package taskrules holds the input preconditions a tasks write has to pass, in one place every transport that performs one can reach: the REST handlers under internal/http/handlers/tasks and the task tools in internal/mcp.
Package taskservice owns transactionally authorized task reads and commands shared by transports and internal callers.
Package taskservice owns transactionally authorized task reads and commands shared by transports and internal callers.
Package taskstate is the canonical write path for task derived_state transitions.
Package taskstate is the canonical write path for task derived_state transitions.
Package taskworkflow owns persisted task review and human handoff lifecycle work that runs outside an HTTP request.
Package taskworkflow owns persisted task review and human handoff lifecycle work that runs outside an HTTP request.
Package webhook implements the background webhook delivery worker.
Package webhook implements the background webhook delivery worker.

Jump to

Keyboard shortcuts

? : This menu
/ : Search site
f or F : Jump to
y or Y : Canonical URL