Directories
¶
| Path | Synopsis |
|---|---|
|
Package apigolden renders the exported Go surface of every public package in the Pulse module as a deterministic, line-oriented text dump.
|
Package apigolden renders the exported Go surface of every public package in the Pulse module as a deterministic, line-oriented text dump. |
|
Package buildinfo is the single source of the Pulse build version.
|
Package buildinfo is the single source of the Pulse build version. |
|
Package cli provides internal CLI wiring and command construction for the pulse binary.
|
Package cli provides internal CLI wiring and command construction for the pulse binary. |
|
Package crosstabfuse is the one fused-crosstab eligibility rule shared by the engine and the no-execute predict layer.
|
Package crosstabfuse is the one fused-crosstab eligibility rule shared by the engine and the no-execute predict layer. |
|
Package dategroup is the one reading of GROUP_DATE's params, shared by the operator factory (internal/processing) and predict (internal/descriptor) so both refuse the same request with the same code and message.
|
Package dategroup is the one reading of GROUP_DATE's params, shared by the operator factory (internal/processing) and predict (internal/descriptor) so both refuse the same request with the same code and message. |
|
Package datepart is the one reading of ATTR_DATE_PART's params and field, shared by the operator factory (internal/processing) and predict (internal/descriptor) so both refuse the same request with the same code and message.
|
Package datepart is the one reading of ATTR_DATE_PART's params and field, shared by the operator factory (internal/processing) and predict (internal/descriptor) so both refuse the same request with the same code and message. |
|
Package daterange is the single compiled {label, start, end} model shared by GROUP_DATE_RANGES, FILTER_DATE_RANGES and the named RangeTables the facade validates at pulse.New time.
|
Package daterange is the single compiled {label, start, end} model shared by GROUP_DATE_RANGES, FILTER_DATE_RANGES and the named RangeTables the facade validates at pulse.New time. |
|
Package descriptor is the internal twin of the public descriptor package: the no-execute builders (manifest, payload JSON Schema, capability declarations), predict, inspect and the request validators.
|
Package descriptor is the internal twin of the public descriptor package: the no-execute builders (manifest, payload JSON Schema, capability declarations), predict, inspect and the request validators. |
|
Package docgen renders an instance's analysis reference — the operator catalog, the glossary and the skill pack — as a deterministic Markdown tree (U21).
|
Package docgen renders an instance's analysis reference — the operator catalog, the glossary and the skill pack — as a deterministic Markdown tree (U21). |
|
Package encoding is the module-internal twin of the public github.com/frankbardon/pulse/encoding package.
|
Package encoding is the module-internal twin of the public github.com/frankbardon/pulse/encoding package. |
|
Package encodingbridge carries the few unexported helpers of the public encoding package that its internal twin (internal/encoding) needs, without the public package exporting them.
|
Package encodingbridge carries the few unexported helpers of the public encoding package that its internal twin (internal/encoding) needs, without the public package exporting them. |
|
Package ewmaparams is the one reading of WIN_EWMA's params, shared by the window factory (internal/processing/window) and predict (internal/descriptor) so both refuse the same request with the same message.
|
Package ewmaparams is the one reading of WIN_EWMA's params, shared by the window factory (internal/processing/window) and predict (internal/descriptor) so both refuse the same request with the same message. |
|
Package examples embeds the catalogue of runnable Pulse request JSON files and exposes a search/get API over them.
|
Package examples embeds the catalogue of runnable Pulse request JSON files and exposes a search/get API over them. |
|
Package exprenv is the one shared expr-lang formula environment Pulse compiles ATTR_FORMULA, FILTER_EXPRESSION, total() arguments and OVERLAY_FORMULA against.
|
Package exprenv is the one shared expr-lang formula environment Pulse compiles ATTR_FORMULA, FILTER_EXPRESSION, total() arguments and OVERLAY_FORMULA against. |
|
Package exprident is the one parse-only reading of the names an expr-lang expression mentions: the free identifiers it reads from its env and the functions it calls by name.
|
Package exprident is the one parse-only reading of the names an expr-lang expression mentions: the free identifiers it reads from its env and the functions it calls by name. |
|
Package facadebridge carries the few in-module hooks that sibling packages (the MCP go-sdk adapter) need from a *pulse.Pulse without the root facade exporting its engine handle.
|
Package facadebridge carries the few in-module hooks that sibling packages (the MCP go-sdk adapter) need from a *pulse.Pulse without the root facade exporting its engine handle. |
|
Package fieldaccept is the ONE accepted-field-types table: for each built-in operator slot that reads a field's value, the field types it accepts and the coded refusal it raises for any other type.
|
Package fieldaccept is the ONE accepted-field-types table: for each built-in operator slot that reads a field's value, the field types it accepts and the coded refusal it raises for any other type. |
|
Package formulaident is the one OVERLAY_FORMULA identifier reading: the AST walk that splits a formula's references into variables, called functions and Compose `slot.<label>.<field>` paths (Collect), the function set an overlay formula may call (AllowedFuncs), and the Compose-host namespace plus its refusal (ComposeRefusal).
|
Package formulaident is the one OVERLAY_FORMULA identifier reading: the AST walk that splits a formula's references into variables, called functions and Compose `slot.<label>.<field>` paths (Collect), the function set an overlay formula may call (AllowedFuncs), and the Compose-host namespace plus its refusal (ComposeRefusal). |
|
Package fs provides the filesystem abstraction layer for pulse storage backends.
|
Package fs provides the filesystem abstraction layer for pulse storage backends. |
|
Package groupedtests is the one reading of tier-1 tests on a grouped request (U46 E3).
|
Package groupedtests is the one reading of tier-1 tests on a grouped request (U46 E3). |
|
Package groupfit is the one reading of a data-dependent grouper's params.fit (GROUP_QUANTILE, GROUP_KMEANS): "global" (the default) fits the grouper ONCE over the whole filtered set, whatever its position; "within" refits it inside each bucket of the groupers before it — the outer segment — so [region, quartile] gives per-region quartiles.
|
Package groupfit is the one reading of a data-dependent grouper's params.fit (GROUP_QUANTILE, GROUP_KMEANS): "global" (the default) fits the grouper ONCE over the whole filtered set, whatever its position; "within" refits it inside each bucket of the groupers before it — the outer segment — so [region, quartile] gives per-region quartiles. |
|
Package guide holds the logic behind Pulse's guidance surfaces — Recommend (an intent to ranked draft requests) and Explain (a request to plain-language steps).
|
Package guide holds the logic behind Pulse's guidance surfaces — Recommend (an intent to ranked draft requests) and Explain (a request to plain-language steps). |
|
Package imports manages tabular-source imports with a TTL-tracked on-disk pool.
|
Package imports manages tabular-source imports with a TTL-tracked on-disk pool. |
|
Package io defines the I/O pipeline framework for Pulse: Reader/Writer interfaces, schema inference, and job types (ImportJob, ExportJob, ConvertJob).
|
Package io defines the I/O pipeline framework for Pulse: Reader/Writer interfaces, schema inference, and job types (ImportJob, ExportJob, ConvertJob). |
|
arrow
Package arrow provides Arrow IPC (Feather V2) import and export for the pulse I/O pipeline, plus shared Arrow<->Pulse type-mapping helpers used by both this package and internal/io/parquet.
|
Package arrow provides Arrow IPC (Feather V2) import and export for the pulse I/O pipeline, plus shared Arrow<->Pulse type-mapping helpers used by both this package and internal/io/parquet. |
|
csv
Package csv provides CSV format adapters for the Pulse I/O pipeline.
|
Package csv provides CSV format adapters for the Pulse I/O pipeline. |
|
excel
Package excel provides Excel import and export for the pulse I/O pipeline.
|
Package excel provides Excel import and export for the pulse I/O pipeline. |
|
exportoverlay
Package exportoverlay holds the higher-level integration tests for the ExportJob and ConvertJob overlay-embedding wiring.
|
Package exportoverlay holds the higher-level integration tests for the ExportJob and ConvertJob overlay-embedding wiring. |
|
jsonarray
Package jsonarray provides JSON-array import and export for the pulse I/O pipeline.
|
Package jsonarray provides JSON-array import and export for the pulse I/O pipeline. |
|
jsonshared
Package jsonshared holds value coercion helpers shared by the ndjson and jsonarray packages.
|
Package jsonshared holds value coercion helpers shared by the ndjson and jsonarray packages. |
|
ndjson
Package ndjson provides NDJSON (newline-delimited JSON) import and export for the pulse I/O pipeline.
|
Package ndjson provides NDJSON (newline-delimited JSON) import and export for the pulse I/O pipeline. |
|
nullcell
Package nullcell holds the cross-adapter integration tests for the TWO absent-looking states of a `categorical_*` column — a null cell and a cell whose value IS the empty string.
|
Package nullcell holds the cross-adapter integration tests for the TWO absent-looking states of a `categorical_*` column — a null cell and a cell whose value IS the empty string. |
|
parquet
Package parquet provides Parquet import and export for the pulse I/O pipeline.
|
Package parquet provides Parquet import and export for the pulse I/O pipeline. |
|
settristate
Package settristate holds the cross-adapter integration tests for the THREE states of a `set_*` column — null, empty mask ("answered, selected nothing") and non-empty mask.
|
Package settristate holds the cross-adapter integration tests for the THREE states of a `set_*` column — null, empty mask ("answered, selected nothing") and non-empty mask. |
|
setwide
Package setwide holds the per-adapter wide-set round-trip tests: one test per tabular format, proving that a 206-member `set_u256` column survives an export and a re-import with every bit in the place it started.
|
Package setwide holds the per-adapter wide-set round-trip tests: one test per tabular format, proving that a 206-member `set_u256` column survives an export and a re-import with every bit in the place it started. |
|
spss
Package spss reads SPSS `.sav` system files for the Pulse I/O pipeline.
|
Package spss reads SPSS `.sav` system files for the Pulse I/O pipeline. |
|
tsv
Package tsv provides TSV import and export for the pulse I/O pipeline.
|
Package tsv provides TSV import and export for the pulse I/O pipeline. |
|
veclist
Package veclist holds the per-adapter tests for importing a NATIVE list column as a vector field (`--vector NAME` with no column list): Arrow FixedSizeList and LIST, Parquet LIST, an NDJSON array and a JSON-array file.
|
Package veclist holds the per-adapter tests for importing a NATIVE list column as a vector field (`--vector NAME` with no column list): Arrow FixedSizeList and LIST, Parquet LIST, an NDJSON array and a JSON-array file. |
|
Package iocore is the leaf that holds the tabular I/O contracts every format adapter implements: Reader, Writer and the optional interfaces the shared import / export / convert paths discover by type assertion, plus the handful of cell conventions (set delimiter, empty-set marker, null-cell test, stop-iteration sentinel, set-width ladder) the adapters and the jobs must agree on.
|
Package iocore is the leaf that holds the tabular I/O contracts every format adapter implements: Reader, Writer and the optional interfaces the shared import / export / convert paths discover by type assertion, plus the handful of cell conventions (set delimiter, empty-set marker, null-cell test, stop-iteration sentinel, set-width ladder) the adapters and the jobs must agree on. |
|
Package jsonfinite is the read-side inverse of types.MarshalFinite.
|
Package jsonfinite is the read-side inverse of types.MarshalFinite. |
|
Package limits is the one definition of Pulse's instance resource limits: the Limits struct the root facade aliases as pulse.Limits, the built-in defaults, the per-field precedence resolver, the construction-time validation and the shared constructors every PULSE_LIMIT_* raise site uses.
|
Package limits is the one definition of Pulse's instance resource limits: the Limits struct the root facade aliases as pulse.Limits, the built-in defaults, the per-field precedence resolver, the construction-time validation and the shared constructors every PULSE_LIMIT_* raise site uses. |
|
Package mcp is the SDK-free core of the Pulse MCP surface.
|
Package mcp is the SDK-free core of the Pulse MCP surface. |
|
toolmeta
Package toolmeta holds the metadata table for the MCP tools registered by the Pulse MCP layer.
|
Package toolmeta holds the metadata table for the MCP tools registered by the Pulse MCP layer. |
|
Package mergegate is the one pure mergeability rule shared by the engine and the no-execute validators.
|
Package mergegate is the one pure mergeability rule shared by the engine and the no-execute validators. |
|
Package model is the one bound-model namespace: the in-memory form of a fitted regression a request reads by name, the set those names resolve in, and the structural rules a ComposedRequest `fits` list must satisfy.
|
Package model is the one bound-model namespace: the in-memory form of a fitted regression a request reads by name, the set those names resolve in, and the structural rules a ComposedRequest `fits` list must satisfy. |
|
coefcall
Package coefcall finds the coef(fit, term[, stat]) calls an ATTR_FORMULA / FILTER_EXPRESSION expression makes with literal arguments and judges them by internal/model.CheckCoef — the static half of the coef() rule, shared by the engine's build (internal/ processing) and the no-execute field-reference pass (internal/ descriptor: predict and the runtime's entry check), so both refuse the same call with the same code, message and details.
|
Package coefcall finds the coef(fit, term[, stat]) calls an ATTR_FORMULA / FILTER_EXPRESSION expression makes with literal arguments and judges them by internal/model.CheckCoef — the static half of the coef() rule, shared by the engine's build (internal/ processing) and the no-execute field-reference pass (internal/ descriptor: predict and the runtime's entry check), so both refuse the same call with the same code, message and details. |
|
Package obsprom is Pulse's stdlib-only Prometheus exporter: an observe.Metrics implementation that keeps its instruments in memory and renders them in the Prometheus text exposition format (version 0.0.4) over net/http.
|
Package obsprom is Pulse's stdlib-only Prometheus exporter: an observe.Metrics implementation that keeps its instruments in memory and renders them in the Prometheus text exposition format (version 0.0.4) over net/http. |
|
Package overlayhost is the one declaration of WHICH overlay slot each catalog kind runs on, and the one refusal a kind authored on any other slot gets.
|
Package overlayhost is the one declaration of WHICH overlay slot each catalog kind runs on, and the one refusal a kind authored on any other slot gets. |
|
Package paramread is the ONE way built-in code reads an operator's `params` object: every runtime decode of a slot's Params blob (or a lookup into an overlay's params map) goes through Decode / DecodeOptional / Get / Read, naming the operator it reads for.
|
Package paramread is the ONE way built-in code reads an operator's `params` object: every runtime decode of a slot's Params blob (or a lookup into an overlay's params map) goes through Decode / DecodeOptional / Get / Read, naming the operator it reads for. |
|
Package processing provides the single dynamic processing engine for Pulse.
|
Package processing provides the single dynamic processing engine for Pulse. |
|
arena
Package arena provides a bump-allocator backed by a single contiguous []byte.
|
Package arena provides a bump-allocator backed by a single contiguous []byte. |
|
feature
Package feature implements the FEAT_* operators that run pre-filter to add derived columns to a record stream.
|
Package feature implements the FEAT_* operators that run pre-filter to add derived columns to a record stream. |
|
multiplicity
Package multiplicity is the pure multiple-comparison correction core: it maps one vector of raw p-values to its adjusted twin under a named method (bonferroni, holm, bh, by, none), matching R's stats::p.adjust.
|
Package multiplicity is the pure multiple-comparison correction core: it maps one vector of raw p-values to its adjusted twin under a named method (bonferroni, holm, bh, by, none), matching R's stats::p.adjust. |
|
regression
Package regression hosts the REG_* operators that fit a regression model against the filtered record set.
|
Package regression hosts the REG_* operators that fit a regression model against the filtered record set. |
|
window
Package window implements the WIN_* window operators for Pulse.
|
Package window implements the WIN_* window operators for Pulse. |
|
Package profilefile reads a feature profile from a host OS path.
|
Package profilefile reads a feature profile from a host OS path. |
|
Package regcov is the one rule over a regression's covariance block (types.RegressionSpec.Covariance), shared by the no-execute predict pass (internal/descriptor) and the regression engines (internal/processing/regression) so the two refuse the same requests with the same code and details.
|
Package regcov is the one rule over a regression's covariance block (types.RegressionSpec.Covariance), shared by the no-execute predict pass (internal/descriptor) and the regression engines (internal/processing/regression) so the two refuse the same requests with the same code and details. |
|
Package returnplan is the schema-free core of response shaping (`Request.Return`): the path grammar, the compiled selection plan and its digest, and the per-node verdict a pruner or wire encoder asks while walking a response.
|
Package returnplan is the schema-free core of response shaping (`Request.Return`): the path grammar, the compiled selection plan and its digest, and the per-node verdict a pruner or wire encoder asks while walking a response. |
|
Package returnshape applies a resolved `return` plan to a finished Response.
|
Package returnshape applies a resolved `return` plan to a finished Response. |
|
Package seriesfield is the one reading of a series overlay's `params.field`: the OUTPUT LABEL of the request aggregation the overlay scores, or one expanded per-element column "<label>[<element label>]" of an array-valued aggregation under params.expand.
|
Package seriesfield is the one reading of a series overlay's `params.field`: the OUTPUT LABEL of the request aggregation the overlay scores, or one expanded per-element column "<label>[<element label>]" of an array-valued aggregation under params.expand. |
|
Package seriespartition is the one reading of a series overlay's `params.partition_by` and the one partition engine over a grouped host's composite rows.
|
Package seriespartition is the one reading of a series overlay's `params.partition_by` and the one partition engine over a grouped host's composite rows. |
|
Package service provides the orchestration layer for pulse operations.
|
Package service provides the orchestration layer for pulse operations. |
|
Package shardfixtures is the single source of truth for the canonical shard archives committed under testdata/sharding/.
|
Package shardfixtures is the single source of truth for the canonical shard archives committed under testdata/sharding/. |
|
Package skills provides the embedded skill pack for LLM-driven agents.
|
Package skills provides the embedded skill pack for LLM-driven agents. |
|
Package spsssidecar names the SPSS metadata sidecar that sits beside a cohort.
|
Package spsssidecar names the SPSS metadata sidecar that sits beside a cohort. |
|
Package spsstest builds spec-conformant SPSS `.sav` system files from a declarative spec, for use as test fixtures.
|
Package spsstest builds spec-conformant SPSS `.sav` system files from a declarative spec, for use as test fixtures. |
|
Package statdist holds the distribution primitives shared by the statistical operators: the Student-t tail, CDF, quantile and two-sided critical value, the regularized incomplete beta they rest on, and the standard normal quantile (NormalQuantile).
|
Package statdist holds the distribution primitives shared by the statistical operators: the Student-t tail, CDF, quantile and two-sided critical value, the regularized incomplete beta they rest on, and the standard normal quantile (NormalQuantile). |
|
Package strictjson is the ONE strict request decoder: every JSON request root Pulse accepts — the CLI request files, the MCP tool arguments, a Compose sweep body, a for_each item and a rendered request template — decodes through it, so an unknown key anywhere in the document is refused the same way on every path.
|
Package strictjson is the ONE strict request decoder: every JSON request root Pulse accepts — the CLI request files, the MCP tool arguments, a Compose sweep body, a for_each item and a rendered request template — decodes through it, so an unknown key anywhere in the document is refused the same way on every path. |
|
Package sweep is the one rule set for a Compose parameter sweep (types.SweepSpec, the `sweep` slot of a ComposedRequest) and for the item fan-out that reuses its axes and substitution (types.ForEach, the `for_each` key on a window, feature or attribute — items.go, ExpandItems).
|
Package sweep is the one rule set for a Compose parameter sweep (types.SweepSpec, the `sweep` slot of a ComposedRequest) and for the item fan-out that reuses its axes and substitution (types.ForEach, the `for_each` key on a window, feature or attribute — items.go, ExpandItems). |
|
Package synth produces synthetic .pulse cohorts from either a schema declaration ("from-schema") or a statistical profile of a real cohort ("from-profile").
|
Package synth produces synthetic .pulse cohorts from either a schema declaration ("from-schema") or a statistical profile of a real cohort ("from-profile"). |
|
Package template turns a stored, parameterised JSON document into a validated Pulse request.
|
Package template turns a stored, parameterised JSON document into a validated Pulse request. |
|
Package temporal is the single home of Pulse's epoch-day and calendar arithmetic.
|
Package temporal is the single home of Pulse's epoch-day and calendar arithmetic. |
|
tools
|
|
|
docsummary
command
Command docsummary splices the SUMMARY.md fragment a `pulse docs export` writes into the book's own SUMMARY.md, between the docgen.BookSpanBegin / BookSpanEnd lines, prefixing every path with the export directory.
|
Command docsummary splices the SUMMARY.md fragment a `pulse docs export` writes into the book's own SUMMARY.md, between the docgen.BookSpanBegin / BookSpanEnd lines, prefixing every path with the export directory. |
|
pkgsplit
command
Command pkgsplit is the in-module AST rewriter used to split a public package in place: the kept subset stays in the public directory, the remainder moves to an internal twin that imports the public package.
|
Command pkgsplit is the in-module AST rewriter used to split a public package in place: the kept subset stays in the public directory, the remainder moves to an internal twin that imports the public package. |
|
refcohorts
command
Command refcohorts converts the R oracle's vendored fixture CSVs into the `.pulse` cohorts service tests read.
|
Command refcohorts converts the R oracle's vendored fixture CSVs into the `.pulse` cohorts service tests read. |
|
sites
command
Command sites prints the change-site checklist for a Pulse change: every file + symbol a change must touch, the gate tests to rerun and the goldens to regenerate.
|
Command sites prints the change-site checklist for a Pulse change: every file + symbol a change must touch, the gate tests to rerun and the goldens to regenerate. |
|
Package totalcall finds the total(expr) calls an expression makes and judges where they may appear — the one rule shared by the engine (internal/processing: ATTR_FORMULA's two-pass build, the expression filterer's and overlay formula's refusals), the merge gate (internal/mergegate) and the no-execute field-reference pass (internal/descriptor: predict and the runtime's entry check).
|
Package totalcall finds the total(expr) calls an expression makes and judges where they may appear — the one rule shared by the engine (internal/processing: ATTR_FORMULA's two-pass build, the expression filterer's and overlay formula's refusals), the merge gate (internal/mergegate) and the no-execute field-reference pass (internal/descriptor: predict and the runtime's entry check). |
|
Package twosample is the one reading of the explicit per-side inputs the Compose two-sample overlays (OVERLAY_T_VS_REF, OVERLAY_Z_VS_REF, OVERLAY_T_CELL, OVERLAY_Z_CELL) take when a side's mean arrives as a bare scalar: its variance and its sample size, from the spec's params.
|
Package twosample is the one reading of the explicit per-side inputs the Compose two-sample overlays (OVERLAY_T_VS_REF, OVERLAY_Z_VS_REF, OVERLAY_T_CELL, OVERLAY_Z_CELL) take when a side's mean arrives as a bare scalar: its variance and its sample size, from the spec's params. |
|
Package vecmath holds the stateless vector and scalar maths kernels behind the expression-language vector built-ins (vsum, vmean, dot, argmax, vzscore, vnormalize, sqrt, ...).
|
Package vecmath holds the stateless vector and scalar maths kernels behind the expression-language vector built-ins (vsum, vmean, dot, argmax, vzscore, vnormalize, sqrt, ...). |
|
Package vectors is the one resolution of Request.Vectors: it turns each types.VectorSpec into its ordered member list against a schema, refusing malformed specs and unsupported member types with the PULSE_VECTOR_* codes.
|
Package vectors is the one resolution of Request.Vectors: it turns each types.VectorSpec into its ordered member list against a schema, refusing malformed specs and unsupported member types with the PULSE_VECTOR_* codes. |
|
Package weighting is the one declaration of how built-in operators treat a resolved row weight, plus the per-row weight-validity rule.
|
Package weighting is the one declaration of how built-in operators treat a resolved row weight, plus the per-row weight-validity rule. |
Click to show internal directories.
Click to hide internal directories.