@peernova/cuneiform-sf 1.0.2 → 1.0.4-beta.6

package/messages/object.list.md

@@ -0,0 +1,443 @@
+# summary
+
+Enumerate Salesforce objects with record counts, type classifications, and namespace distribution — so you can identify which objects hold customer data and focus profiling on what matters.
+
+# description
+
+A typical Salesforce org contains 500 to 2,000 objects. Most are empty platform objects, managed package internals, or system metadata. Finding the objects that actually hold customer data — the ones worth profiling — requires navigating Object Manager, running SOQL counts, and cross-referencing namespace prefixes. This command transforms that exploration into a single call with filter flags and enrichment options.
+
+The default customer-facing classification filter focuses attention on objects most likely relevant for profiling scope decisions. Record counts distinguish populated objects from empty shells. Namespace distribution reveals how the org's data is partitioned across standard Salesforce, industry clouds, managed packages, and custom development.
+
+**Six output sections:**
+
+- **Org Identity** — org name, edition, instance URL
+- **Summary Statistics** — total objects, objects with records, standard/custom/external counts, namespace distribution
+- **Namespace Distribution** — objects grouped by standard, industry, managed, and custom categories
+- **Objects Table** — name, label, record count, type, namespace — plus optional enrichment columns
+- **Contact Points** — email, phone, and URL field details (when `--with-contact-points` is specified)
+- **Next Steps** — `object describe` for field-level deep dives, `definition create` for profiling scope
+
+NATURAL LANGUAGE → FLAG MAPPING:
+
+"Which objects have data?" → `--with-records`
+"What custom objects exist?" → `--filter custom`
+"What did CPQ add to this org?" → `--namespace SBQQ`
+"Which objects match a name?" → `--pattern Account*`
+"Which objects have meaningful volume?" → `--min-records 1000`
+"Which objects can be assigned to users?" → `--with-owner`
+"Which objects have record type segmentation?" → `--with-record-types`
+"Where are email, phone, and address fields?" → `--with-contact-points`
+"How complex is each object?" → `--with-fields`
+"Which objects reference other objects?" → `--with-references`
+
+**How this differs from `object describe`:** This command shows the broad inventory across many objects. Use `object describe` when you need the deep dive on a specific object's fields, record types, relationships, and data age.
+
+Read-only. Does not create, modify, or delete records or metadata. Results default to customer-facing classification, sorted by record count descending, paginated at 50 with a visible notice when more exist.
+
+COMMAND SEQUENCE: `org details` (understand the org landscape) → `object list` (identify objects of interest) → `object describe` (deep dive on specific objects) → `definition create` (define profiling scope)
+
+# flags.target-org.summary
+
+List objects from this Salesforce org. Specify the org alias or username when you have multiple authenticated orgs.
+
+# flags.object.summary
+
+Fetch a single object by API name — bypasses all filters and the limit cap, and always returns the real record count. Use this when you know the exact object you need (e.g., `--object Lead`). Mutually exclusive with --filter (non-default), --namespace, --pattern, --without-records, and --min-records.
+
+# flags.filter.summary
+
+Filter by object type: `standard`, `custom`, or `all`. Use `custom` to audit custom data model objects or `standard` to focus on platform objects. Defaults to `all`.
+
+# flags.namespace.summary
+
+Filter by namespace prefix (case-insensitive). Scope to a specific managed package — e.g., `SBQQ` for CPQ, `FinServ` for Financial Services Cloud. Use an empty string for unmanaged objects only.
+
+# flags.pattern.summary
+
+Filter by API name pattern with wildcard support. Examples: `Account*` matches Account and AccountContactRelation; `*__c` matches custom objects.
+
+# flags.with-records.summary
+
+Show only objects that contain data (record count > 0). Filters out empty platform infrastructure and focuses on populated objects worth profiling.
+
+# flags.without-records.summary
+
+Show only empty objects (record count = 0). Identifies unused objects during org cleanup or newly provisioned objects awaiting data.
+
+# flags.with-owner.summary
+
+Show only objects with an OwnerId field — objects whose records can be assigned to users. Identifies ownership-trackable data for profiling scope.
+
+# flags.with-record-types.summary
+
+Show only objects with record types defined. Record types indicate segmented data entry or business processes — relevant for deciding whether to use record-type-based profiling.
+
+# flags.with-business-process.summary
+
+Add a business process count column showing lifecycle processes (Lead, Opportunity, Case, Solution). Identifies objects with stage-based workflows before profiling.
+
+# flags.with-fields.summary
+
+Add field count columns (total fields and custom fields) to gauge object complexity. Identifies objects with large field inventories before running `object describe`.
+
+# flags.with-references.summary
+
+Add a reference/lookup field count column. High reference counts indicate hub objects in the data model with dense relationship networks.
+
+# flags.classification.summary
+
+Object classification filter: `customer` (customer-facing objects most relevant to profiling, the default), `internal` (system/platform objects), or `all`. The customer-facing filter uses heuristics based on object type, namespace, and naming patterns.
+
+# flags.with-contact-points.summary
+
+Add contact point columns showing email, phone, and URL field counts per object. Discovers identity resolution candidates before a contact point analysis engagement.
+
+# flags.min-records.summary
+
+Minimum record count threshold. Show only objects with at least this many records (e.g., `--min-records 1000` to focus on high-volume objects).
+
+# flags.sort.summary
+
+Sort results by: `name` (alphabetical), `recordCount` (highest first, the default), or `label`.
+
+# flags.limit.summary
+
+Maximum objects to display (1-200, default: 50). A notice appears when results are truncated — increase to see more, or use --pattern / --object to bypass this cap entirely.
+
+# examples
+
+- Explore a new org — see customer-facing objects sorted by data volume (the default starting point):
+
+  <%= config.bin %> <%= command.id %> --target-org myOrg
+
+- Custom object audit — inventory custom objects for a handoff document or data model review:
+
+  <%= config.bin %> <%= command.id %> --target-org myOrg --filter custom
+
+- Namespace-focused scope — see how Financial Services Cloud objects are populated:
+
+  <%= config.bin %> <%= command.id %> --target-org myOrg --namespace FinServ --with-fields --with-record-types
+
+- Profiling candidates — focus on high-volume objects worth profiling:
+
+  <%= config.bin %> <%= command.id %> --target-org myOrg --with-records --min-records 1000 --sort recordCount
+
+- Contact point discovery — find objects with email, phone, or address fields before an analysis engagement:
+
+  <%= config.bin %> <%= command.id %> --target-org myOrg --with-contact-points --with-records
+
+- Complexity assessment — add field and reference counts to identify hub objects in the data model:
+
+  <%= config.bin %> <%= command.id %> --target-org myOrg --with-fields --with-references --with-records
+
+# output.title
+
+Cuneiform Object Listing for %s (%s)
+
+# output.identity.header
+
+Org Identity
+
+# output.identity.orgName
+
+Org Name
+
+# output.identity.orgId
+
+Org ID
+
+# output.identity.instanceUrl
+
+Instance URL
+
+# output.identity.orgType
+
+Org Type
+
+# output.identity.edition
+
+Edition
+
+# output.identity.namespace
+
+Namespace
+
+# output.identity.username
+
+Username
+
+# errors.mutuallyExclusiveFlags
+
+Cannot specify both %s and %s. These flags are mutually exclusive.
+
+# errors.objectNotFound
+
+Object "%s" was not found in this org. Check the API name spelling and run without --object to browse available objects.
+
+# errors.noTargetOrg
+
+Could not determine target org username
+
+# errors.orgIdentityFailed
+
+Could not retrieve org identity
+
+# output.summary.header
+
+Summary
+
+# output.summary.totalObjects
+
+Total Objects
+
+# output.summary.withRecords
+
+With Records
+
+# output.summary.withoutRecords
+
+Without Records
+
+# output.summary.standard
+
+Standard
+
+# output.summary.custom
+
+Custom
+
+# output.summary.withRecordTypes
+
+With Record Types
+
+# output.summary.withOwner
+
+With Owner
+
+# output.summary.external
+
+External
+
+# output.summary.withNamespace
+
+With Namespace
+
+# output.summary.withoutNamespace
+
+Without Namespace
+
+# output.namespaceDistribution.header
+
+Namespace Distribution
+
+# output.namespaceDistribution.noNamespace
+
+No Namespace
+
+# output.namespaceDistribution.columns.prefix
+
+Prefix
+
+# output.namespaceDistribution.columns.label
+
+Label
+
+# output.namespaceDistribution.columns.count
+
+Count
+
+# output.objects.header
+
+Objects
+
+# output.objects.limitNotice
+
+Displaying the top %s objects. Use --limit to show more or less objects.
+
+# output.objects.totalLabel
+
+Total
+
+# output.objects.noNamespace
+
+No Namespace
+
+# output.objects.typeCustom
+
+Custom
+
+# output.objects.typeStandard
+
+Standard
+
+# output.objects.columns.prefix
+
+Prefix
+
+# output.objects.columns.objectLabel
+
+Object Label
+
+# output.objects.columns.records
+
+Records
+
+# output.objects.columns.recordTypes
+
+Rec. Types
+
+# output.objects.columns.businessProcess
+
+Processes
+
+# output.objects.columns.totalFields
+
+Fields
+
+# output.objects.columns.custom
+
+Custom
+
+# output.objects.columns.reference
+
+Reference
+
+# output.objects.columns.totalCPs
+
+Total CPs
+
+# output.objects.columns.email
+
+Email
+
+# output.objects.columns.phone
+
+Phone
+
+# output.objects.columns.url
+
+Url
+
+# output.contactPoints.header
+
+Contact Point Fields
+
+# output.contactPoints.email
+
+Email
+
+# output.contactPoints.phone
+
+Phone
+
+# output.contactPoints.url
+
+URL
+
+# output.filters.type
+
+Type: %s
+
+# output.filters.namespace
+
+Namespace: %s
+
+# output.filters.pattern
+
+Pattern: %s
+
+# output.filters.withRecords
+
+With records only
+
+# output.filters.withoutRecords
+
+Without records only
+
+# output.filters.withOwner
+
+With OwnerId field
+
+# output.filters.withRecordTypes
+
+With record types
+
+# output.filters.withBusinessProcess
+
+With business processes
+
+# output.filters.withFields
+
+With field counts
+
+# output.filters.withReferences
+
+With reference fields
+
+# output.filters.withContactPoints
+
+With contact points
+
+# output.filters.classification
+
+Classification: %s
+
+# output.filters.minRecords
+
+Min records: %s
+
+# spinner.listing
+
+Listing
+
+# spinner.objectsNoun
+
+objects
+
+# spinner.enriching
+
+Enriching objects
+
+# output.patternHeader
+
+Pattern
+
+# errors.listFailed
+
+Object list failed
+
+# warnings.sortWithoutRecords
+
+Sorting by recordCount without --with-records: all record counts will be 0 and order will be arbitrary. Add --with-records to sort by actual data volume.
+
+# output.entityType
+
+objects
+
+# output.noResults.suggestion
+
+Try relaxing or removing the most restrictive filters
+
+# output.nextSteps.header
+
+Next steps:
+
+# output.nextSteps.describeLabel
+
+Describe %s
+
+# output.nextSteps.describeCommand
+
+sf cuneiform object describe %s --target-org %s
+
+# output.nextSteps.describeCommandNoOrg
+
+sf cuneiform object describe %s --help
+
+# output.nextSteps.definitionCreateLabel
+
+Create a profiling definition
+
+# output.nextSteps.definitionCreateCommand
+
+sf cuneiform definition create --help