AccuroTech Internal Shapes

Raw source view

docs/projects/xtratype-link/shape_stub.md

# XtraType Link Shape Stub

**Status:** Day-Two informative scaffold, not final canon.
**Source inputs:** `accurotech_seed_document_v0_0_1.md`; `accurotech_seed_boot_v0_0_1.md`; global Shape Catalogue JSON; Day-One summary/log; instance record; Day-Two plan.
**Payload safety:** Metadata and documentation only; excludes private keys, live credentials, tokens, deployment secrets, private customer payloads, concrete private observations, and secret operational data.

## Identity
- Slug: `xtratype-link`
- Names / aliases: XtraType Link
- Namespace(s): `XTL` (XtraType Link and reference resolution), `XT` (XtraType annotation and references), `REL` (Cross-system relationships and data pipelines)
- Related domains, if stated in seed documents: `xtyp.link`
- Current maturity: Documentation scaffold and catalogue-aligned planning surface; implementation maturity is not claimed here.

## Seed Canon Summary
- Companion system for XtraType that provides short links and/or global reference IDs for XT references.
- Seed canon frames it as more than a generic URL shortener: a canonical reference-resolution layer.

- Cross-ecosystem seed canon preserves the core triad: XtraType gives meaning, CRE8 gives authority, and PortaShape gives structure.
- Seed canon also says AccuroTech projects are early, built/rebuilt through iteration, generally internal-first/public-later, and not to be overclaimed as mature public production systems.

## Catalogue Alignment
Relevant catalogue namespaces and records include:
- `XTL-001` — XtraType Link System (`xtratype_link_system`, kind `entity_shape`; category: XtraType Link and Global Reference Resolution; fields: system_name, role, resolution_scope, assignment_policy, stage; relationships: extends_xtratype, resolves_reference; payload: `template_base_only_no_instance_payload`).
- `XTL-002` — Global Reference ID (`global_reference_id`, kind `property_shape`; category: XtraType Link and Global Reference Resolution; fields: id_slot, namespace_slot, customization_policy, uniqueness_rule, resolution_rule; relationships: identifies_reference_base, may_identify_annotation; payload: `template_base_only_no_instance_payload`).
- `XTL-003` — Short Link Record Base (`short_link_record_base`, kind `record_shape`; category: XtraType Link and Global Reference Resolution; fields: short_id, target_reference, target_type, owner_slot, visibility_policy; relationships: resolves_to_reference, may_use_cre8_access; payload: `template_base_only_no_instance_payload`).
- `XTL-004` — Automatic Annotation Link (`automatic_annotation_link`, kind `workflow_shape`; category: XtraType Link and Global Reference Resolution; fields: annotation_reference, id_generation_rule, customization_rule, collision_policy, publication_policy; relationships: creates_global_reference_id, links_annotation_base; payload: `template_base_only_no_instance_payload`).
- `XTL-005` — Custom Reference Alias (`custom_reference_alias`, kind `property_shape`; category: XtraType Link and Global Reference Resolution; fields: alias_slot, canonical_id, owner_policy, collision_policy, revocation_policy; relationships: aliases_global_reference_id; payload: `template_base_only_no_instance_payload`).
- `XTL-006` — External URL Shortener Target (`external_url_shortener_target`, kind `relationship_shape`; category: XtraType Link and Global Reference Resolution; fields: source_short_link, external_url_slot, target_policy, safety_policy, metadata_policy; relationships: extends_short_link_record_base; payload: `template_base_only_no_instance_payload`).
- `XTL-007` — xtyp.link Catalogue Entry (`xtyp_catalogue_entry`, kind `record_shape`; category: XtraType Link and Global Reference Resolution; fields: entry_label, reference_target, conversation_scope, owner_slot, access_policy; relationships: may_link_to_xtratype_annotation; payload: `template_base_only_no_instance_payload`).
- `XTL-008` — Reference Resolution Policy (`reference_resolution_policy`, kind `policy_shape`; category: XtraType Link and Global Reference Resolution; fields: resolution_order, permission_check, fallback_behavior, metadata_disclosure, audit_rule; relationships: governs_short_link_record_base; payload: `template_base_only_no_instance_payload`).
- `XT-001` — XtraType System (`xtratype_system`, kind `entity_shape`; category: XtraType Annotation and Reference Meaning; fields: system_name, role, reference_scope, annotation_scope, stage; relationships: uses_cre8, uses_portashape_schema, feeds_notes_pipeline; payload: `template_base_only_no_instance_payload`).
- `XT-002` — Reference Base (`reference_base`, kind `entity_shape`; category: XtraType Annotation and Reference Meaning; fields: reference_type, locator_slot, display_label, context_slot, resolution_policy; relationships: targeted_by_annotation, may_have_xtyp_link; payload: `template_base_only_no_instance_payload`).
- `XT-003` — Annotation Base (`annotation_base`, kind `entity_shape`; category: XtraType Annotation and Reference Meaning; fields: reference_target, annotation_type, comment_slot, structured_payload_slot, metadata_slots; relationships: attaches_to_reference, may_use_shape_schema, protected_by_cre8; payload: `template_base_only_no_instance_payload`).
- `XT-004` — Text Comment Annotation (`text_comment_annotation`, kind `template_shape`; category: XtraType Annotation and Reference Meaning; fields: reference_target, comment_text_slot, context_slot, author_slot, visibility_policy; relationships: extends_annotation_base; payload: `template_base_only_no_instance_payload`).
- `XT-005` — Highlighted Text Annotation (`highlighted_text_annotation`, kind `template_shape`; category: XtraType Annotation and Reference Meaning; fields: reference_target, highlight_slot, comment_slot, source_context, quote_policy; relationships: extends_annotation_base; payload: `template_base_only_no_instance_payload`).
- `XT-006` — Typed Annotation (`typed_annotation`, kind `template_shape`; category: XtraType Annotation and Reference Meaning; fields: annotation_type, type_schema_reference, allowed_fields, validation_rule, display_rule; relationships: extends_annotation_base, defined_by_portashape; payload: `template_base_only_no_instance_payload`).
- `XT-007` — Note Annotation (`note_annotation`, kind `template_shape`; category: XtraType Annotation and Reference Meaning; fields: reference_target, note_slot, tag_slots, collection_context, review_state; relationships: extends_typed_annotation; payload: `template_base_only_no_instance_payload`).
- `XT-008` — Claim Annotation (`claim_annotation`, kind `template_shape`; category: XtraType Annotation and Reference Meaning; fields: reference_target, claim_text_slot, support_slots, confidence_slot, review_state; relationships: extends_typed_annotation, may_link_to_citation_annotation; payload: `template_base_only_no_instance_payload`).
- `XT-009` — Correction Annotation (`correction_annotation`, kind `template_shape`; category: XtraType Annotation and Reference Meaning; fields: reference_target, error_summary, correction_slot, basis_slots, status; relationships: extends_typed_annotation, may_update_canon_document; payload: `template_base_only_no_instance_payload`).
- `XT-010` — Citation Annotation (`citation_annotation`, kind `template_shape`; category: XtraType Annotation and Reference Meaning; fields: reference_target, cited_reference, support_type, excerpt_policy, relevance_note; relationships: extends_typed_annotation, supports_claim_annotation; payload: `template_base_only_no_instance_payload`).
- `XT-011` — Warning Annotation (`warning_annotation`, kind `template_shape`; category: XtraType Annotation and Reference Meaning; fields: reference_target, warning_summary, severity_slot, evidence_slots, visibility_policy; relationships: extends_typed_annotation, may_feed_report; payload: `template_base_only_no_instance_payload`).
- `XT-012` — Question Annotation (`question_annotation`, kind `template_shape`; category: XtraType Annotation and Reference Meaning; fields: reference_target, question_text, question_type, owner_slot, resolution_state; relationships: extends_typed_annotation, may_feed_open_question; payload: `template_base_only_no_instance_payload`).
- `XT-013` — Observation Annotation (`observation_annotation`, kind `template_shape`; category: XtraType Annotation and Reference Meaning; fields: reference_target, observation_text, time_slot, observer_slot, evidence_slots; relationships: extends_typed_annotation, may_feed_observation_record; payload: `template_base_only_no_instance_payload`).
- `XT-014` — Definition Annotation (`definition_annotation`, kind `template_shape`; category: XtraType Annotation and Reference Meaning; fields: reference_target, term_slot, definition_slot, scope_slot, authority_status; relationships: extends_typed_annotation, may_promote_to_canon_term; payload: `template_base_only_no_instance_payload`).
- `XT-015` — Task Note Annotation (`task_note_annotation`, kind `template_shape`; category: XtraType Annotation and Reference Meaning; fields: reference_target, task_summary, owner_slot, status_slot, workflow_candidate; relationships: extends_typed_annotation, may_feed_bot_task_template; payload: `template_base_only_no_instance_payload`).
- `XT-016` — Report Evidence Annotation (`report_evidence_annotation`, kind `template_shape`; category: XtraType Annotation and Reference Meaning; fields: reference_target, evidence_type, evidence_summary, chain_of_context, access_policy; relationships: extends_typed_annotation, may_feed_is_bad_works_report; payload: `template_base_only_no_instance_payload`).
- `XT-017` — Reference Collection (`reference_collection`, kind `content_shape`; category: XtraType Annotation and Reference Meaning; fields: collection_name, reference_slots, purpose, curation_policy, access_policy; relationships: contains_reference_base, may_feed_shape_proposal; payload: `template_base_only_no_instance_payload`).
- `XT-018` — Shared Language Term (`shared_language_term`, kind `content_shape`; category: XtraType Annotation and Reference Meaning; fields: term, meaning_slot, scope, related_terms, canon_status; relationships: may_be_defined_by_definition_annotation, may_be_catalogued_as_shape; payload: `template_base_only_no_instance_payload`).
- `REL-001` — Core Triad Relationship (`core_triad_relationship`, kind `relationship_shape`; category: Cross-System Integration and Data Pipelines; fields: meaning_system, authority_system, structure_system, integration_goal, reuse_policy; relationships: links_xtratype_cre8_portashape; payload: `template_base_only_no_instance_payload`).
- `REL-002` — Reference-Meaning-Authority-Structure Pipeline (`reference_meaning_authority_structure_pipeline`, kind `workflow_shape`; category: Cross-System Integration and Data Pipelines; fields: reference_step, meaning_step, authority_step, structure_step, automation_step; relationships: uses_xtratype, uses_cre8, uses_portashape; payload: `template_base_only_no_instance_payload`).
- `REL-003` — CRE8 Protects Project (`cre8_protects_project`, kind `relationship_shape`; category: Cross-System Integration and Data Pipelines; fields: protected_system, credential_scope, access_model, provenance_requirement, stage; relationships: source_cre8_system, target_project_system; payload: `template_base_only_no_instance_payload`).
- `REL-004` — XtraType Annotates Project (`xtratype_annotates_project`, kind `relationship_shape`; category: Cross-System Integration and Data Pipelines; fields: target_system, reference_types, annotation_types, visibility_policy, shape_schema_policy; relationships: source_xtratype_system, target_project_system; payload: `template_base_only_no_instance_payload`).
- `REL-005` — PortaShape Structures Project (`portashape_structures_project`, kind `relationship_shape`; category: Cross-System Integration and Data Pipelines; fields: target_system, shape_families, template_scope, validation_policy, canon_status; relationships: source_portashape_system, target_project_system; payload: `template_base_only_no_instance_payload`).
- `REL-006` — Weather-to-Happenstuff Pipeline (`weather_to_happenstuff_pipeline`, kind `workflow_shape`; category: Cross-System Integration and Data Pipelines; fields: weather_observation, publication_target, annotation_policy, access_policy, review_rule; relationships: source_weather_observer, target_happenstuff; payload: `template_base_only_no_instance_payload`).
- `REL-007` — Report-to-Stewardship Pipeline (`report_to_stewardship_pipeline`, kind `workflow_shape`; category: Cross-System Integration and Data Pipelines; fields: source_report, evidence_bundle, aggregation_target, review_rule, stewardship_context; relationships: source_is_bad_works, target_last_christian_church; payload: `template_base_only_no_instance_payload`).
- `REL-008` — Bot Task Context Pipeline (`bot_task_context_pipeline`, kind `workflow_shape`; category: Cross-System Integration and Data Pipelines; fields: task_template, authority_grant, reference_context, expected_output, audit_record; relationships: uses_bot_maistro, uses_cre8, uses_xtratype, uses_portashape; payload: `template_base_only_no_instance_payload`).
- `REL-009` — Creative Milestone Pipeline (`creative_milestone_pipeline`, kind `workflow_shape`; category: Cross-System Integration and Data Pipelines; fields: milestone_record, session_history, creative_trigger, artifact_template, publication_policy; relationships: source_doc_milestone, target_toons_codes; payload: `template_base_only_no_instance_payload`).

## Role in the AccuroTech Ecosystem
- XtraType gives meaning by attaching annotations, references, and shared language where this project needs semantic context.
- CRE8 gives authority by providing identity, credentials, delegated access, provenance, and permission boundaries where this project needs governed participation.
- PortaShape gives structure by defining reusable schemas, templates, workflow patterns, reports, posts, observations, tasks, or canon documents.
- This project should remain understandable as a standalone surface while also fitting into the broader AccuroTech system-of-systems.

## Known Fields
- Project slug, name/aliases, and at least one catalogue namespace alignment.
- Day-Two status as an informative scaffold rather than formal canon.
- Payload-safety exclusion requirements.
- Relationship to AccuroTech and, where applicable, to the meaning/authority/structure triad.

## Missing / Unresolved Fields
- Human-approved canonical description and launch status.
- Formal owner/steward, public domain inventory, and repository-to-service mapping.
- Exact implementation inventory, if any, outside this documentation scaffold.
- Formal schemas, API boundaries, data-retention rules, and review workflows.

## Implementation Status
- Implemented: this documentation page and catalogue alignment notes only.
- Scaffolded: project folder, Shape stub, and Day-Two planning references.
- Planned or inferred: workflows, schemas, public products, communities, automations, and integrations described as future directions unless supported by later repository evidence.
- Missing or unclear: runnable source code, deployment configuration, production readiness, active users, and operational data are not claimed by this document.

## Day Two Build Direction
- Promote the most relevant catalogue records into project-specific canon candidates.
- Identify the first safe schema or workflow artifact that can be specified without secrets or private payloads.
- Add source-basis notes for each claim so future automation can distinguish seed canon from bounded inference.
- Decide which cross-project relationships should become formal Shape relationship records.

## Day Three and Beyond
- Add formal validation rules, instance examples with synthetic data, and review workflows.
- Connect implementation repositories or modules only after they are inspected.
- Prepare public/developer documentation when the human steward confirms launch posture and payload policy.