---

Class ::nsmcp::AccessCardinalityStore

::nsmcp::AccessCardinalityStore create ... \
           [ -agentPending (default "0") ] \
           [ -attached (default "false") ] \
           [ -buffer (default "") ] \
           [ -checkpoint:required checkpoint:required ] \
           [ -data data ] \
           [ -db (default "") ] \
           [ -directory:required directory:required ] \
           [ -events (default "0") ] \
           [ -handle (default "") ] \
           [ -limits:required limits:required ] \
           [ -peerPending (default "0") ] \
           [ -readResults:boolean (default "false") ]

Defined in /usr/local/ns/tcl/nsmcp/log-traffic-aggregate.tcl

Class Relations

• class: ::nx::Class
• superclass: ::nsmcp::Object

Methods (to be applied on instances)

• add (scripted, public)

   <instance of nsmcp::AccessCardinalityStore> add row redactor

  Accumulate peer and user-agent observations from a request. Apply the redactor and configured capacity limits before buffering distinct-observation updates.

  Parameters:

  row (required)

  Parsed access-request record.

  redactor (required)

  Redactor object applied before returning diagnostic evidence.

  Returns:

  The observation update result.

  Testcases:

  No testcase defined.

• close (scripted, public)

   <instance of nsmcp::AccessCardinalityStore> close

  Release cardinality-store resources. Destroy the accumulator and allow its destructor to flush or close owned resources.

  Returns:

  The object destruction result.

  Testcases:

  No testcase defined.

• flush (scripted, public)

   <instance of nsmcp::AccessCardinalityStore> flush

  Persist buffered cardinality observations. Write pending observations to the optional cache and retain explicit capacity or storage failure state.

  Returns:

  The flush result, or an empty result when no observations are pending.

  Testcases:

  No testcase defined.

• readable (scripted, public)

   <instance of nsmcp::AccessCardinalityStore> readable

  Report whether the cardinality cache owns a readable database session. This is a current-state check, not a new pool checkout.

  Returns:

  True when a database session is present, otherwise false.

  Testcases:

  No testcase defined.

• results (scripted, public)

   <instance of nsmcp::AccessCardinalityStore> results limit \
      expectedPeers expectedAgents

  Build bounded peer and agent cardinality evidence. Flush observations and compare observed diversity with expected counts to report lower bounds and omissions.

  Parameters:

  limit (required)

  Maximum number of records or entries to return.

  expectedPeers (required)

  Expected peer observation count used to assess completeness.

  expectedAgents (required)

  Expected user-agent observation count used to assess completeness.

  Returns:

  The cardinality result dictionary.

  Testcases:

  No testcase defined.

• snapshot (scripted, public)

   <instance of nsmcp::AccessCardinalityStore> snapshot

  Return current cardinality accumulator state. Flush pending observations before reading the stored counters and completeness flags.

  Returns:

  The cardinality state dictionary.

  Testcases:

  No testcase defined.

---