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. |
|
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. |
Click to show internal directories.
Click to hide internal directories.