Skip to content
Open
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
64 changes: 64 additions & 0 deletions ticker-collision-brief/README.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,64 @@
# Ticker Collision Brief

Free standalone BankrBot utility. Public-safe shared ticker lifecycle context only.

## Summary

Ticker Collision Brief answers a single bounded question:

> For a given ticker, how many observed entries share it, and when were
> those observations first seen?

No more. No per-token rows, no ordering, no authenticity resolution, no operator guidance.

## Scope

- Tier: free
- Placement: standalone BankrBot skill
- Remy dependency: none
- Version target: v0.1
- Paid features: none
- Paid tier: none

## Included fields (v0.1)

- ticker
- shared_ticker_count
- first_observed_range.earliest
- first_observed_range.latest
- pair_emergence_count
- no_pair_at_check_time_count
- pair_status_unknown_count
- operator_review_required
- public_safe
- not_a_verdict
- not_identity_attribution
- not_a_recommendation

## Not included (held)

- contract_created_range
- volume_band_distribution
- liquidity_band_distribution
- source artifact hashes
- agent-readable receipt
- raw identifiers
- per-token detail

## Files

- SKILL.md
- manifest.yaml
- output_contract.md
- SAFETY.md
- REVIEW.md
- examples/ticker-collision-brief-example.md

## Safety

All outputs carry mandatory safety flags. No identifier leakage is
allowed in the free tier.

## Submission

Marked for operator review. Implementation is skipped in this package.
49 changes: 49 additions & 0 deletions ticker-collision-brief/REVIEW.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,49 @@
# Ticker Collision Brief — Submission Review (v0.1)

Purpose: confirm package completeness and submission readiness.

## Check results

- [x] SKILL.md present
- [x] README.md present
- [x] manifest.yaml present
- [x] output_contract.md present
- [x] SAFETY.md present
- [x] REVIEW.md present
- [x] examples/ticker-collision-brief-example.md present
- [x] Standalone flag set; no Remy core dependency
- [x] No implementation files included
- [x] No paid features included
- [x] No volume/liquidity fields included
- [x] No contract_created_range included
- [x] No source artifact hashes included
- [x] No agent-readable receipt included
- [x] No raw identifiers included
- [x] No ordering language included
- [x] No authenticity resolution language included

## Scope check

| Item | Status |
|---|---|
| Free public skill | Included |
| Standalone BankrBot utility | Included |
| Shared ticker lifecycle context only | Included |
| Not a discovery tool | Included |
| Not an authenticity resolution tool | Included |
| No selection or prioritization | Included |
| Operator review required | Included |
| No entity attribution in output | Included |

## Readiness

All required artifacts are present.
Output schema matches approved v0.1 boundary.
No implementation attached.
Ready for operator approval.
No PR created.

## Gate

- GO after operator approval
- HOLD for implementation until scope is approved
46 changes: 46 additions & 0 deletions ticker-collision-brief/SAFETY.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,46 @@
# Ticker Collision Brief — Safety Rules (v0.1)

Safety is a hard boundary, not a guideline.
Any output that violates these rules must not be produced.

## Prohibited content and language

- No raw addresses
- No transaction hashes
- No per-token rows
- No top/bottom listings
- No volume/liquidity bands in v0.1
- No contract_created_range in v0.1
- No real/fake wording
- No scam/rug/fraud/verdict language
- No buy/sell/hold language
- No price predictions
- No wallet or entity attribution
- No token ranking
- No individual token recommendation

## Required outputs

Every output must include the following flags:

- operator_review_required: true
- public_safe: true or false
- not_a_verdict: true
- not_identity_attribution: true
- not_a_recommendation: true

## Output review rule

Output is public-safe only if all required flags are present and no
prohibited content is detected. If public_safe is false, operator review
is required before publication.

## Future scope caution

Later versions must not use the following concepts to rebuild disallowed
output through indirect fields:

- indirect authenticity scoring
- inferred token maturity
- inferred operator identity
- implied quality through presentation order
57 changes: 57 additions & 0 deletions ticker-collision-brief/SKILL.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,57 @@
---
name: ticker-collision-brief
title: Ticker Collision Brief
description: >
Free standalone BankrBot utility. Provides public-safe shared ticker
lifecycle context only. Neutral aggregate context tool with no selection,
no prioritization, and no authenticity resolution.
version: 0.1.0
tier: free
category: utility
standalone: true
remy_core_dependency: none
operator_review_required: true
---

# Ticker Collision Brief

Shared ticker lifecycle context utility for BankrBot.

## What it is

Ticker Collision Brief is a public-safe aggregate memory snapshot. It
shows how many observed tokens share a given ticker and their lifecycle
patterns across observation runs.

## What it is not

- Not a discovery tool.
- Not an authenticity resolution tool.
- Not a token comparison tool.
- Not a selection or prioritization tool.
- No operator or entity attribution in output.
- No operational guidance implied.
- No trading guidance implied.

## Output contract (v0.1)

Every output must contain exactly the free-tier fields defined in
`output_contract.md`. No additional fields may be added to the public
brief without operator review and a scope update.

## Safety rules

See `SAFETY.md`. These are hard constraints, not suggestions.

## Usage steps

1. Receive ticker input.
2. Count observed entries sharing that ticker.
3. Report first observed timestamps.
4. Report pair emergence counts.
5. Apply free-tier schema.
6. Gate output on safety flags.

## Readiness

See `REVIEW.md` for submission readiness checklist.
34 changes: 34 additions & 0 deletions ticker-collision-brief/examples/ticker-collision-brief-example.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,34 @@
# Ticker Collision Brief — Example (v0.1)

## Input

- ticker: EXAMPLE

## Output

```markdown
# Ticker Collision Brief — EXAMPLE

ticker: EXAMPLE
shared_ticker_count: 3
first_observed_range.earliest: 2026-05-14T10:00:00Z
first_observed_range.latest: 2026-06-03T08:00:00Z
pair_emergence_count: 2
no_pair_at_check_time_count: 0
pair_status_unknown_count: 1

operator_review_required: true
public_safe: true
not_a_verdict: true
not_identity_attribution: true
not_a_recommendation: true
```

## Notes

- This example demonstrates the exact v0.1 output shape.
- No per-token rows.
- No ordering.
- No authenticity resolution.
- No volume, liquidity, contract, or source verification fields.
- Public brief only.
33 changes: 33 additions & 0 deletions ticker-collision-brief/manifest.yaml
Original file line number Diff line number Diff line change
@@ -0,0 +1,33 @@
name: ticker-collision-brief
title: "Ticker Collision Brief"
summary: >
Free standalone BankrBot utility. Provides public-safe shared ticker
lifecycle context only. Neutral aggregate context tool with no selection,
no prioritization, and no authenticity resolution.
version: "0.1.0"
tier: free
category: utility
placement: standalone
depends_on_remy_core: false
depends_on_external_api: false
allowed_output_tiers:
- public
- operator
required_safety_flags:
- not_a_verdict
- not_identity_attribution
- not_a_recommendation
- operator_review_required
contract_file: output_contract.md
safety_file: SAFETY.md
example_file: examples/ticker-collision-brief-example.md
submission_package: true
root_path: /tmp/bankr-skills-submission-ticker-collision-brief
files:
- SKILL.md
- README.md
- manifest.yaml
- output_contract.md
- SAFETY.md
- REVIEW.md
- examples/ticker-collision-brief-example.md
59 changes: 59 additions & 0 deletions ticker-collision-brief/output_contract.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,59 @@
# Ticker Collision Brief — Output Contract (v0.1)

This contract defines the exact schema that public and operator outputs
must follow. No extra fields may be appended by skill logic unless the
contract is updated and the package is revised.

## Tier

- Public brief: exact field set below.
- Internal-only extensions are allowed in operator review files, but
must not be merged into the public brief without scope change.

## Public brief schema

```yaml
ticker: string
shared_ticker_count: integer
first_observed_range:
earliest: string # ISO-8601 datetime
latest: string # ISO-8601 datetime
pair_emergence_count: integer
no_pair_at_check_time_count: integer
pair_status_unknown_count: integer
operator_review_required: true
public_safe: true # Present only if output passes safety scan
not_a_verdict: true
not_identity_attribution: true
not_a_recommendation: true
```

## Invariants

- shared_ticker_count >= 0
- pair_emergence_count + no_pair_at_check_time_count + pair_status_unknown_count == shared_ticker_count
- No raw addresses
- No transaction hashes
- No per-token rows
- No volume/liquidity band fields
- No contract_created_range fields

## Display

```markdown
# Ticker Collision Brief — EXAMPLE

ticker: EXAMPLE
shared_ticker_count: 3
first_observed_range.earliest: 2026-05-14T10:00:00Z
first_observed_range.latest: 2026-06-03T08:00:00Z
pair_emergence_count: 2
no_pair_at_check_time_count: 0
pair_status_unknown_count: 1

operator_review_required: true
public_safe: true
not_a_verdict: true
not_identity_attribution: true
not_a_recommendation: true
```