@tiinex/core 0.1.1

package/src/schemas/core/relation/tiinex.relation.v1.schema.source.js

@@ -0,0 +1,9 @@
+import binding from './tiinex.relation.v1.schema.json' with { type: 'json' };
+import projection from './tiinex.relation.v1.schema.runtime.json' with { type: 'json' };
+import { defineBundledSchemaSource } from '../../schema.source.js';
+
+export const schemaSource = defineBundledSchemaSource(binding, projection, Object.freeze({
+  bundledPath: 'src/schemas/core/relation/tiinex.relation.v1.schema.md',
+  sourceLabel: 'Viewer schema registry',
+  assetUrl: new URL('./tiinex.relation.v1.schema.md', import.meta.url).href
+}));

package/src/schemas/core/relation/tiinex.relation.v1.sv.i18n.json

@@ -0,0 +1,4 @@
+{
+  "schema.label": "Relation",
+  "schema.summary": "Typad icke-föräldrarelation."
+}

package/src/schemas/core/relation/tiinex.relation.v1.transitions.js

@@ -0,0 +1 @@
+export const relationTransitions = Object.freeze([{ id: 'inspect', label: 'Inspect', sideEffect: 'none' }]);

package/src/schemas/core/relation/tiinex.relation.v1.validate.js

@@ -0,0 +1,36 @@
+import { RELATION_DECLARATION_FIELDS, RELATION_REQUIRED_SECTIONS } from './tiinex.relation.v1.contract.js';
+
+export function relationValidate(artifact = {}) {
+  const findings = [];
+  if (artifact?.envelope?.current?.schema?.id !== 'tiinex.relation.v1') {
+    return [finding('warning', 'relation.schema.mismatch', 'Relation validator invoked for non-relation current schema.')];
+  }
+  const body = String(artifact?.body?.text || '');
+  const sections = new Set(Array.isArray(artifact?.body?.sections) ? artifact.body.sections : []);
+  if (!artifact?.body?.title) findings.push(finding('error', 'relation.title.missing', 'Relation artifact should begin with a human-readable title.'));
+  for (const section of RELATION_REQUIRED_SECTIONS) {
+    if (!sections.has(section)) findings.push(finding('error', 'relation.section.missing', `Relation body is missing required ${section} section.`, { section }));
+  }
+  for (const field of RELATION_DECLARATION_FIELDS) {
+    if (!fieldValue(body, field)) findings.push(finding('error', 'relation.field.missing', `Relation Declaration is missing ${field}.`, { field }));
+  }
+  const boundary = sectionBody(body, 'Relation Boundary');
+  if (boundary && !/not\s+(?:the\s+)?(?:tiinex\s+continuity\s+)?parent/i.test(boundary)) {
+    findings.push(finding('error', 'relation.boundary.parent-confusion', 'Relation Boundary must explicitly preserve that the relation target is not Parent.'));
+  }
+  if (!findings.some((item) => item.severity === 'error')) {
+    findings.push(finding('info', 'relation.contract.readable', 'Relation body exposes the required typed non-parent relation contract.'));
+  }
+  return findings;
+}
+
+function fieldValue(body = '', field = '') {
+  const escaped = String(field).replace(/[.*+?^${}()|[\]\\]/g, '\\$&');
+  return String(body).match(new RegExp(`^\\s*-\\s*${escaped}:\\s*(.+)$`, 'm'))?.[1]?.trim() || '';
+}
+function sectionBody(body = '', name = '') {
+  const escaped = String(name).replace(/[.*+?^${}()|[\]\\]/g, '\\$&');
+  const match = String(body).match(new RegExp(`^##\\s+${escaped}\\s*$([\\s\\S]*?)(?=^##\\s+|^#\\s+Continuity Integrity\\s*$|(?![\\s\\S]))`, 'm'));
+  return match?.[1]?.trim() || '';
+}
+function finding(severity, code, message, params = {}) { return { severity, code, messageKey: code, message, source: 'tiinex.relation.v1', params }; }

package/src/schemas/core/relation/workspace/representation/tiinex.workspace.representation.v1.capabilities.js

@@ -0,0 +1,14 @@
+export const workspaceRepresentationCapabilities = Object.freeze({
+  canCreateArtifact: false,
+  canBeParent: true,
+  canRenderFallback: false,
+  supportedSurfaces: Object.freeze(['feed','tree','detail','lineage','preview','share']),
+  boundaries: Object.freeze([
+    'relation-is-not-parent',
+    'workspace-identity-separate-from-payload',
+    'external-payload-owns-payload-integrity',
+    'complete-and-bounded-provider-activation-remain-distinct',
+    'bounded-scope-is-exact-qualified-decoded-entry-set',
+    'detached-recovery-is-not-representation-membership'
+  ])
+});

package/src/schemas/core/relation/workspace/representation/tiinex.workspace.representation.v1.contract.js

@@ -0,0 +1,57 @@
+export const WORKSPACE_REPRESENTATION_REQUIRED_SECTIONS = Object.freeze([
+  'Representation Binding',
+  'Representation Correlation',
+  'Provider Qualification',
+  'Relation Boundary',
+  'Interpretation Limits'
+]);
+
+export const WORKSPACE_REPRESENTATION_SCOPE_FIELDS = Object.freeze([
+  'Scope Basis',
+  'Included Entry Authority',
+  'Omitted Entry Meaning',
+  'Source Membership Claim',
+  'Recovery Closure Boundary'
+]);
+
+export const WORKSPACE_REPRESENTATION_REQUIRED_FIELDS = Object.freeze({
+  'Representation Binding': Object.freeze(['Workspace Artifact', 'Representation Payload', 'Representation Kind', 'Coverage', 'Binding State']),
+  'Representation Correlation': Object.freeze(['Workspace Tree Root', 'Workspace Artifact Inner Path', 'Archive Entry Root', 'Path Mapping', 'Collision Policy', 'Decoder Requirement']),
+  'Provider Qualification': Object.freeze(['Activation Rule', 'Payload Integrity Requirement', 'Coverage Requirement', 'Staleness Rule', 'Selection Rule', 'Multi-Workspace Isolation']),
+  'Relation Boundary': Object.freeze(['Parent Boundary', 'Workspace Identity Boundary', 'Payload Identity Boundary', 'Transport Boundary', 'Outer Integrity Boundary']),
+  'Interpretation Limits': Object.freeze(['Does Not Prove', 'Must Not Be Used As'])
+});
+
+export const WORKSPACE_REPRESENTATION_FIXED_VALUES = Object.freeze({
+  'Representation Kind': Object.freeze(['exact-workspace-byte-tree-archive', 'exact-bounded-workspace-byte-tree-archive']),
+  Coverage: Object.freeze(['complete', 'bounded', 'partial', 'unknown']),
+  'Binding State': Object.freeze(['verified', 'declared', 'stale', 'unresolved']),
+  'Scope Basis': Object.freeze(['exact-representation-entry-set']),
+  'Included Entry Authority': Object.freeze(['qualified-decoded-entry-set']),
+  'Omitted Entry Meaning': Object.freeze(['outside-representation-not-absent-from-workspace']),
+  'Source Membership Claim': Object.freeze(['represented-entries-are-workspace-relative-source-bytes']),
+  'Recovery Closure Boundary': Object.freeze(['separate-qualified-closure']),
+  'Path Mapping': Object.freeze(['identity-relative-paths', 'manifest']),
+  'Collision Policy': Object.freeze(['reject-ambiguous-or-unsafe-paths']),
+  'Activation Rule': Object.freeze(['verified-complete-only', 'verified-bounded-only']),
+  'Payload Integrity Requirement': Object.freeze(['verified-exact-payload-bytes']),
+  'Coverage Requirement': Object.freeze(['complete', 'bounded']),
+  'Staleness Rule': Object.freeze(['requalify-on-binding-relevant-change']),
+  'Selection Rule': Object.freeze(['exactly-one-binding-per-workspace', 'explicit-binding-per-bounded-scope']),
+  'Multi-Workspace Isolation': Object.freeze(['independent-binding-closure'])
+});
+
+export const WORKSPACE_REPRESENTATION_READY_CONTRACTS = Object.freeze({
+  complete: Object.freeze({
+    representationKind: 'exact-workspace-byte-tree-archive',
+    activationRule: 'verified-complete-only',
+    coverageRequirement: 'complete',
+    selectionRule: 'exactly-one-binding-per-workspace'
+  }),
+  bounded: Object.freeze({
+    representationKind: 'exact-bounded-workspace-byte-tree-archive',
+    activationRule: 'verified-bounded-only',
+    coverageRequirement: 'bounded',
+    selectionRule: 'explicit-binding-per-bounded-scope'
+  })
+});

package/src/schemas/core/relation/workspace/representation/tiinex.workspace.representation.v1.en.i18n.json

@@ -0,0 +1,4 @@
+{
+  "schema.label": "Workspace Representation",
+  "schema.summary": "Explicit Workspace-to-representation binding with fail-closed provider qualification."
+}

package/src/schemas/core/relation/workspace/representation/tiinex.workspace.representation.v1.findings.js

@@ -0,0 +1,13 @@
+export const workspaceRepresentationFindings = Object.freeze({ namespace: 'tiinex.workspace.representation.v1', defaultSeverity: 'info', codes: Object.freeze({
+  'workspace-representation.schema.mismatch': finding('warning','manual'),
+  'workspace-representation.title.missing': finding('error','manual'),
+  'workspace-representation.section.missing': finding('error','manual'),
+  'workspace-representation.field.missing': finding('error','manual'),
+  'workspace-representation.field.domain-invalid': finding('error','manual'),
+  'workspace-representation.endpoint.workspace-invalid': finding('error','manual'),
+  'workspace-representation.endpoint.payload-invalid': finding('error','manual'),
+  'workspace-representation.mapping.manifest-missing': finding('error','manual'),
+  'workspace-representation.binding.verified-incomplete': finding('error','manual'),
+  'workspace-representation.contract.readable': finding('info','none')
+}) });
+function finding(severity, fixability) { return Object.freeze({ severity, messageKey: '', fixability }); }

package/src/schemas/core/relation/workspace/representation/tiinex.workspace.representation.v1.presenter.js

@@ -0,0 +1,3 @@
+export function workspaceRepresentationPresent(artifact = {}, context = {}) {
+  return { title: artifact?.title || 'Workspace Representation', summary: artifact?.summary || 'Explicit Workspace-to-representation binding.', badges: ['concrete','tiinex.workspace.representation.v1'], disclosure: context.degraded ? 'degraded' : 'normal' };
+}

package/src/schemas/core/relation/workspace/representation/tiinex.workspace.representation.v1.schema.js

@@ -0,0 +1,20 @@
+import { defineSchemaModule } from '../../../../contracts.js';
+import binding from './tiinex.workspace.representation.v1.schema.json' with { type: 'json' };
+import { schemaSource } from './tiinex.workspace.representation.v1.schema.source.js';
+import { workspaceRepresentationCapabilities } from './tiinex.workspace.representation.v1.capabilities.js';
+import { workspaceRepresentationValidate } from './tiinex.workspace.representation.v1.validate.js';
+import { workspaceRepresentationPresent } from './tiinex.workspace.representation.v1.presenter.js';
+import { workspaceRepresentationTransitions } from './tiinex.workspace.representation.v1.transitions.js';
+import workspaceRepresentationI18nEn from './tiinex.workspace.representation.v1.en.i18n.json' with { type: 'json' };
+import workspaceRepresentationI18nSv from './tiinex.workspace.representation.v1.sv.i18n.json' with { type: 'json' };
+import { workspaceRepresentationFindings } from './tiinex.workspace.representation.v1.findings.js';
+import { WORKSPACE_REPRESENTATION_REQUIRED_SECTIONS } from './tiinex.workspace.representation.v1.contract.js';
+
+export const workspaceRepresentationSchemaModule = defineSchemaModule({
+  id: 'tiinex.workspace.representation.v1', label: 'Workspace Representation', kind: 'concrete', role: 'core-workspace-representation-binding', parentSchemaId: 'tiinex.relation.v1',
+  schemaSource, summary: 'Explicit Workspace-to-External-Payload representation binding with deterministic correlation and fail-closed provider qualification.', binding,
+  capabilities: workspaceRepresentationCapabilities, validate: workspaceRepresentationValidate, present: workspaceRepresentationPresent,
+  read: Object.freeze({ label: 'Workspace Representation', sections: WORKSPACE_REPRESENTATION_REQUIRED_SECTIONS }),
+  viewActions: Object.freeze({ lineage: Object.freeze(['record.open','record.markdown','record.source']) }), transitions: workspaceRepresentationTransitions,
+  i18n: Object.freeze({ en: workspaceRepresentationI18nEn, sv: workspaceRepresentationI18nSv }), findings: workspaceRepresentationFindings
+});

package/src/schemas/core/relation/workspace/representation/tiinex.workspace.representation.v1.schema.json

@@ -0,0 +1,24 @@
+{
+  "schemaId": "tiinex.workspace.representation.v1",
+  "kind": "concrete",
+  "role": "core-workspace-representation-binding",
+  "module": "./tiinex.workspace.representation.v1.schema.js",
+  "snapshot": "./tiinex.workspace.representation.v1.schema.md",
+  "canonicalUri": "tiinex://schemas/relation/workspace/representation/tiinex.workspace.representation.v1",
+  "permalink": "https://github.com/Tiinex/docs/blob/0fdce5f265298321a41cd90cf5382bcb6ae31a13/.topics/.schemas/relation/workspace/representation/tiinex.workspace.representation.v1.schema.md",
+  "rawUrl": "https://raw.githubusercontent.com/Tiinex/docs/0fdce5f265298321a41cd90cf5382bcb6ae31a13/.topics/.schemas/relation/workspace/representation/tiinex.workspace.representation.v1.schema.md",
+  "sourcePath": ".topics/.schemas/relation/workspace/representation/tiinex.workspace.representation.v1.schema.md",
+  "sourceRepository": "Tiinex/docs",
+  "sourceCommit": "0fdce5f265298321a41cd90cf5382bcb6ae31a13",
+  "sourceBlobSha": "ace693274518fe3d27bd50e7023ae1e0c95bcce7",
+  "checksum": {
+    "algorithm": "sha256",
+    "value": "69b7d91a8e4b64f2a1510d83e4d001a015ab723967d401dea386acc2d878e233"
+  },
+  "capabilityContract": "tiinex.schema.module.v1",
+  "snapshotCompleteness": "exact-axiom-canonical-unpublished-bounded-workspace-contract",
+  "bindingVersion": "tiinex.web.schema-binding.v1",
+  "originId": "tiinex-docs-0fdce5f2-accepted-local",
+  "originTrustRole": "canonical-core",
+  "publicationState": "accepted-local-unpublished"
+}