MyJackfruit

Help
Browse topics · Records: adding, changing and linking

Records: adding, changing and linking

← Records: adding, changing and linking

What are tags on things (scanning, sensors)?

Checked against GilbApp d529620.

A tag is a name a record can be found by, such as PT-101 for a pressure sensor; at most one is its main tag.

Deeper

Also asked:

How do I give a record a tag so I can find it again? In Records, select the record; at the top of its right pane, type the tag in Add tag and press Return. You must be allowed to write to the record. A tag is unique in its vault, so it names that one record.

A record is one piece of data with its own address, such as a person, a place, a thing or a note. Its tags are names people and programs find it by, beside that address. A tag is unique in its vault, the place where a person or a group keeps their records: two records in one vault cannot hold the same tag. A new tag has no @ sign, no space and no invisible character, its letters are all of one script, such as the Latin alphabet, and it is at most 64 characters long in all.

In GilbApp, a record's tags show at the top of its right pane: its main tag under TAG, where the ⧉ beside TAG copies the record's tag with its vault's name, not the address, and its other tags under YOUR TAGS. A person who may write to the record can type a new tag in Add tag and press Return, make another tag the main one with Make main, or take one off with ×. Someone who may only read sees the tags and cannot change them. A record with no tag yet shows No tag yet.; when someone who may write to it opens it, GilbPlatform gives it a main tag made from its name, or from the first words of its text, or else from its kind and a number.

A Plan card, a spec written in your plan, has a tag such as Save.LocalFirst, set from the card's TAG when the card is made, and it becomes its main tag; GilbApp shows Change the Unit tag field to change it. under it, and that tag cannot be taken off or replaced as the main one. The answer on tagging and linking specs explains Plan tags, and the answer on tagging points in a standard explains a standard's tags.

For equipment, a tag often follows a tag standard, such as ISA-5.1 or KKS, in which each part of the tag means something, such as the kind of instrument and its number. GilbPlatform can hold such a standard's rules as data and decode a tag by them into facts on the tagged record, or show what it would write without writing it. A tag that could not be decoded can be tried again later.

A sensor's readings can be sent to GilbPlatform by a program, in batches, by someone signed in who may write. GilbPlatform drops a reading that hardly differs from the last one kept, drops readings that come faster than needed, can sum up each stretch of time in one reading, such as its average, and writes a value only when it changed. So a record keeps the readings that matter, not every tick of the sensor.

Neither GilbApp nor GilbPlatform scans codes or labels today. A program that reads a code or a label on a thing, such as a phone app, can look the tag up in a vault and get the record it names, if the program may read that record.

GilbApp has no screen for tag standards, for decoding a tag or for sensor readings: programs do these through GilbPlatform's interface for developers, and the developer guide shows how. The answer on copying a record's address shows the record's pane.

Source: GilbApp ebd9415e7a90de8c289eaa7bb02f40c8ee80cf79 (https://gilb.com/app/version.json read 2026-11-11, dirty false); every GilbApp file cited is byte-identical to af0f04ee (between af0f04ee and ebd9415e, the cited files: empty), so line numbers are read from the unpack (no checkout): src/components/records/RecordTagsSection.tsx:1-9 (layout: main tag, Your tags with Make main and ×, Add tag with Enter, Address; a reader sees tags read-only; an assigned main shows Change the Unit tag field to change it.), :32, :95-200 (Tag, No tag yet., Your tags, Make main, ×, Add tag, uppercase labels), :75 (Copy the tag with the vault name); src/lib/base/recordTags.ts:1-15, :143-177 (readTags, ensureMasterTag: A 403 is not an error: the viewer may not write, addTag, makeMainTag, removeTag); no GilbApp code calls /base/tag/decode or /base/sensor. GilbPlatform 498d29a0dec9a15d167f4b6b5d731382a6bcede0 (https://id.gilb.com/version read 2026-11-11, dirty false); every platform file cited is byte-identical to 4d008a55 except docs/BASE-DEVELOPER-GUIDE.md, whose changes touch none of the parts cited; code read at 498d29a0: src/routes/tag-handle.ts:1-49 (handle, resolve, reassign-master, master, list, ensure, remove, masters, decode-attempt), :469-510 (GET /base/tag/resolve); src/write/tag-auto.ts:1-20 (automatic master tag from the record's name, first free string); docs/BASE-DEVELOPER-GUIDE.md lines 10301-10330 (TagHandle table; ensure the app calls it on first open, a read-only principal and anon get 403; resolve ?tagString=&vault=, a miss for an unreadable record), 10317-10360 (tag capture on write: a:unitTag, a:ruleId become the master, origin assigned; vault-scoped uniqueness, 409), 10444 (vault-unique index is type-blind); src/routes/tag.ts:1-17, :40, :55, :125 (decode a tag string against a tag standard into datoms on the tagged entity; no entity named = dry-run preview, nothing written; LLM fallback not wired); src/routes/sensor.ts:1-14, :68-90 (batch fold; anon 403); src/sensor/reducer.ts:1-25 (deadband, adaptive sampling, window aggregate last|mean|min|max|count, significant-change-only); the code shows: no scanning feature. GilbVeda (public read 2026-11-11, local copy): t:TagHandle ("One registered tag string for a held pod entity ... tagRole (master / alt / hidden — exactly one entry per held entity holds master at a time)"), t:TagStandard ("A tag-decoding standard (ISA-5.1, KKS, CFIHOS, …) whose grammar ... is held as datoms and read LIVE at decode time"), t:TagDecodeStatus (failed reversible), t:TagString, t:TagRole, t:SensorReadingValue, t:Tag (Approved). Capability rows: GilbPlatform.TagHandle (tag-handle.ts), TagCaptureOnWrite (tag-capture-observer.ts:513), TagDecode ("Decode a tag such as PT-101 against a tag standard's grammar ... or preview without writing"), SensorIngest.