@tiinex/core 0.18.0 → 0.20.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@tiinex/core",
-  "version": "0.18.0",
+  "version": "0.20.0",
   "description": "Shared host-neutral Tiinex implementation core for artifacts, schemas, validation, lineage, grounding, Handoffs, provenance and deterministic workflows.",
   "type": "module",
   "sideEffects": true,
@@ -79,6 +79,7 @@
     "./tooling/portable/grounding/grounding.capsule.js": "./src/tooling/portable/grounding/grounding.capsule.js",
     "./tooling/portable/grounding/grounding.participantAuthority.js": "./src/tooling/portable/grounding/grounding.participantAuthority.js",
     "./tooling/portable/grounding/grounding.processApplicability.js": "./src/tooling/portable/grounding/grounding.processApplicability.js",
+    "./tooling/portable/grounding/grounding.implementationSourceAuthority.js": "./src/tooling/portable/grounding/grounding.implementationSourceAuthority.js",
     "./tooling/portable/grounding/grounding.readiness.js": "./src/tooling/portable/grounding/grounding.readiness.js",
     "./tooling/portable/grounding/grounding.workProvenance.js": "./src/tooling/portable/grounding/grounding.workProvenance.js",
     "./tooling/portable/handoff/carrierLineage.js": "./src/tooling/portable/handoff/carrierLineage.js",
@@ -138,7 +139,8 @@
     "./tooling/portable/source/sourceEligibility.js": "./src/tooling/portable/source/sourceEligibility.js",
     "./tooling/portable/comparison/sourceFrontierComparison.js": "./src/tooling/portable/comparison/sourceFrontierComparison.js",
     "./tooling/portable/adapters/node/sourceFrontierComparison.js": "./src/tooling/portable/adapters/node/sourceFrontierComparison.js",
-    "./tooling/portable/handoff/recoveryAcceptanceAudit.js": "./src/tooling/portable/handoff/recoveryAcceptanceAudit.js"
+    "./tooling/portable/handoff/recoveryAcceptanceAudit.js": "./src/tooling/portable/handoff/recoveryAcceptanceAudit.js",
+    "./tooling/portable/grounding/grounding.delegationReadiness.js": "./src/tooling/portable/grounding/grounding.delegationReadiness.js"
   },
   "files": [
     "src",
@@ -170,12 +172,12 @@
     "type": "git",
     "url": "git+https://github.com/Tiinex/core.git"
   },
-  "gitHead": "12321ec2a8d09722b464ef7977afa2dcdc924718",
+  "gitHead": "75e2e1e324fbe2e652a5c94f877ce6bf68e4a521",
   "tiinexRelease": {
     "policy": "tiinex.master-npm-release.v1",
-    "sourceCommit": "12321ec2a8d09722b464ef7977afa2dcdc924718",
-    "sourceTree": "eba0d10ad8f5fc20cc1c98ee88c328fbd4dafa4c",
+    "sourceCommit": "75e2e1e324fbe2e652a5c94f877ce6bf68e4a521",
+    "sourceTree": "3138e1fdb8c064ec3417a55a731310aa8efd66b8",
     "repository": "Tiinex/core",
-    "previousVersion": "0.17.0"
+    "previousVersion": "0.19.0"
   }
 }

package/src/schemas/creation.contracts.js

@@ -181,7 +181,7 @@ export function validateArtifactCreationResult(draft = {}, parentRecord = {}, op
     const parentSchemaAuthority = parentRecord.schemaReferenceAuthority || {};
     const parentSchemaReference = qualifySchemaReferenceValue(parent.schema?.raw || '', parentSchemaAuthority, { requireExactTargetWhenQualified: true });
     for (const [index, message] of (parentSchemaReference.findings || []).entries()) findings.push(error(`creation.parent-schema-reference.${index + 1}`, message));
-    if (parentSchemaAuthority.resolutionState !== 'qualified') findings.push(error('creation.parent-schema-reference.unresolved', 'Exact continuation requires the declared Parent Schema reference authority to be resolver-qualified.'));
+    if (parentSchemaAuthority.resolutionState !== 'qualified') findings.push(error('creation.parent-schema-reference.unresolved', 'Exact continuation requires qualified Parent Schema reference authority at the strength actually known: either an exact target or a qualified historical schema identifier.'));
   } else if (!rootCreation) findings.push(error('creation.parent.required', 'Continuation creation requires an exact supplied Parent authority.'));
 
   if (draft.status !== 'local') findings.push(error('creation.result.status.not-local', 'Creation result must stay local until explicit publication/export.'));

package/src/schemas/party/role/tiinex.party.role.v1.schema.js

@@ -1,6 +1,9 @@
 import { defineSchemaModule } from '../../contracts.js';
+import { genericArtifactCreationImplementation } from '../../creation.renderer.js';
+import { defineArtifactCreationCapability } from '../../creation.capability.js';
 import binding from './tiinex.party.role.v1.schema.json' with { type: 'json' };
 import { schemaSource } from './tiinex.party.role.v1.schema.source.js';
+import { partyRoleValidate } from './tiinex.party.role.v1.validate.js';
 
 export const partyRoleSchemaModule = defineSchemaModule({
   id: 'tiinex.party.role.v1',
@@ -11,6 +14,8 @@ export const partyRoleSchemaModule = defineSchemaModule({
   summary: "Schema for a bounded role, capacity, responsibility, or authority-facing position without treating the role as proof that a particular person holds it.",
   binding,
   schemaSource,
+  artifactCreation: defineArtifactCreationCapability(binding, Object.freeze({ ...genericArtifactCreationImplementation, transitionTypes: Object.freeze(['create-artifact', 'continue-from-record']) })),
+  validate: partyRoleValidate,
   capabilities: Object.freeze({
     supportedSurfaces: Object.freeze(['feed', 'tree', 'detail', 'lineage', 'preview', 'share']),
     canRenderFallback: true,

package/src/schemas/party/role/tiinex.party.role.v1.schema.json

@@ -10,10 +10,10 @@
   "sourcePath": ".topics/.schemas/party/role/tiinex.party.role.v1.schema.md",
   "sourceRepository": "Tiinex/docs",
   "sourceCommit": "3988951208eb9a8926e84ab42625d4b42fa00c2d",
-  "sourceBlobSha": "16687051579d5c850591d4bf4e2dbd9705f83983",
+  "sourceBlobSha": "ba134b998fb3d04a59a3bd5cd951115ea272ebda",
   "checksum": {
     "algorithm": "sha256",
-    "value": "16b6bd63b9ba6044906aa9daa9bd289881171ddc875b3b9e7c2158470ad27828"
+    "value": "2887aef16cf827b78fe38c1a2ba97cb5820d79049729d2cf8696ecf1de828871"
   },
   "capabilityContract": "tiinex.schema.module.v1",
   "snapshotCompleteness": "exact-axiom-canonical-unpublished-bounded-workspace-contract",

package/src/schemas/party/role/tiinex.party.role.v1.schema.md

@@ -0,0 +1,313 @@
+# Continuity Context
+
+- Envelope Schema: [tiinex.root.v1](../../tiinex.root.v1.schema.md)
+- Parent
+  - Parent Schema: [tiinex.party.v1](../tiinex.party.v1.schema.md)
+  - Created At: 2026-06-30 00:00:00
+  - Trace: [tiinex.party.v1.schema.md](../tiinex.party.v1.schema.md)
+  - Origin:
+    - [relative](../tiinex.party.v1.schema.md)
+    - [browse + git](https://github.com/Tiinex/docs/blob/2a40646640f7468bcd250df6988b69e9f047f1bb/.topics/.schemas/party/tiinex.party.v1.schema.md)
+- Current
+  - Current Schema: [tiinex.party.role.v1](tiinex.party.role.v1.schema.md)
+  - Created At: 2026-06-30 00:00:00
+  - Summary: Schema for a bounded role, capacity, responsibility, or authority-facing position without treating the role as proof that a particular person holds it.
+
+---
+
+# Party Role
+
+- Status: draft schema note
+
+## Summary
+
+Schema for a bounded role, capacity, responsibility, or authority-facing position without treating the role as proof that a particular person holds it.
+
+This schema is human-first. It should be readable by a person who knows the parent schema but does not know a specialized app, programming language, management tool, calendar tool, or database.
+
+## Schema Validation Contract
+
+### Party Role Scope
+
+Applies To
+
+- artifacts whose `Current -> Current Schema` is `tiinex.party.role.v1`
+
+Rules
+
+- `tiinex.party.role.v1` identifies artifacts whose main job is to preserve party role semantics.
+- A party role artifact should state its identity, boundary, state, related targets, and interpretation limits in human-readable form.
+- A party role artifact must not silently become proof, consent, authority, attendance, allocation, validation, or truth unless those claims are separately supported by the appropriate schema or method.
+- Prose outside `Schema Validation Contract` may explain the schema, but it does not add required validation rules.
+
+### Parent Party Specialization
+
+Rules
+
+- Party role artifacts specialize the inherited `Party Body` for artifacts whose `Current -> Current Schema` is `tiinex.party.role.v1`.
+- The child body replaces the parent party body sections for `tiinex.party.role.v1` artifacts.
+- `Role Body` is the local body contract for this child schema.
+- Role Identity specializes Party Identity.
+- Role Boundary specializes Party Boundary.
+- Authority And Responsibility Boundary specializes Role Or Capacity without proving authority by itself.
+- Holder Relationship preserves related-party semantics without becoming identity proof.
+- Parent party specialization applies to the artifact body only; it does not alter root continuity, integrity, or parent-origin requirements.
+
+Inheritance Overrides
+
+- party-role-party-body-structure
+  - Merge Operation: override
+  - Parent Schema: tiinex.party.v1
+  - Parent Node: Schema Validation Contract / Party Body / Required Shape
+  - Child Node: Schema Validation Contract / Party Role Body / Required Shape
+  - Reason: Party Role specializes Party by replacing only the generic Party artifact-body structure while retaining compatible non-structural Party semantics and provenance.
+  - Effective Result: Party Role body structure is authoritative for Party Role artifacts; parent-only structural body groups become inactive, while compatible parent contributions targeting surviving Party Role sections remain active.
+
+### Party Role Body
+
+Required Shape
+
+- first body heading after the continuity envelope
+- `## Role Identity` section
+- `## Role Boundary` section
+- `## Authority And Responsibility Boundary` section
+- `## Holder Relationship` section
+- `## Interpretation Limits` section
+
+Optional Sections
+
+- Related Artifacts
+- References
+
+Rules
+
+- A party role artifact should begin with a human-readable title.
+- Required sections should be readable without specialized tooling.
+- Required sections should be structured enough that a reader, tool, or LLM can extract boundaries without guessing.
+- Follow-up sections must not replace the declared boundary and interpretation limits.
+### Role Identity
+
+Required Fields
+
+- Role Label
+- Role Kind
+
+Optional Fields
+
+- Canonical Identifier
+- Organization
+- Project
+- Group
+
+Rules
+
+- `Role Identity` must remain human-readable and bounded.
+- `Role Identity` must state what is known, what is unknown, and what must not be inferred when those limits matter.
+- `Role Identity` may reference relation, evidence, attestation, validation, privacy, source, access, resource, party, event, project, or instrument artifacts when those artifacts own companion semantics.
+
+### Role Boundary
+
+Required Fields
+
+- In Scope
+- Out Of Scope
+
+Optional Fields
+
+- Valid From
+- Valid Until
+- Context
+
+Rules
+
+- `Role Boundary` must remain human-readable and bounded.
+- `Role Boundary` must state what is known, what is unknown, and what must not be inferred when those limits matter.
+- `Role Boundary` may reference relation, evidence, attestation, validation, privacy, source, access, resource, party, event, project, or instrument artifacts when those artifacts own companion semantics.
+
+### Authority And Responsibility Boundary
+
+Required Fields
+
+- May Do
+- Does Not Authorize
+
+Optional Fields
+
+- Required Instrument
+- Delegation
+- Review Boundary
+
+Rules
+
+- `Authority And Responsibility Boundary` must remain human-readable and bounded.
+- `Authority And Responsibility Boundary` must state what is known, what is unknown, and what must not be inferred when those limits matter.
+- `Authority And Responsibility Boundary` may reference relation, evidence, attestation, validation, privacy, source, access, resource, party, event, project, or instrument artifacts when those artifacts own companion semantics.
+
+### Holder Relationship
+
+Required Fields
+
+- Holder State
+- Assignment Modes
+
+Optional Fields
+
+- Current Holder
+- Possible Holder
+- Unknown Holder
+- Relation Artifact
+
+Rules
+
+- `Holder Relationship` must remain human-readable and bounded.
+- `Holder State` is the human-readable bounded holder summary. It must not be used as positive machine authority for holder assignment.
+- `Assignment Modes` is the canonical machine-readable holder-assignment authorization field for artifacts qualified against this current schema revision.
+- Canonical `Assignment Modes` values are: `explicit-session`, `explicit-user-session`, `explicit-role-invocation`, `handoff`, `explicit-participation`.
+- The canonical serialized field value is a comma-separated list of plain canonical tokens, using `, ` as the separator and the canonical token order shown above when more than one mode is present. Aliases, prose, code-span quoting, duplicate values, unknown tokens, and lexical near-matches are not canonical values.
+- A current operational Role that is intended to authorize bounded holder assignment must declare at least one canonical mode. Missing or empty `Assignment Modes` cannot positively authorize a holder binding.
+- `Assignment Modes` authorizes only the named bounded assignment mechanisms. It does not assert a current holder, establish durable holder identity, create participation, make a process applicable, delegate work, authorize source mutation, prove Handoff acceptance, or widen `Possible Holder` and Role-boundary constraints.
+- `handoff` as an assignment mode does not make a Handoff endpoint or package recipient a holder by itself; separately qualified Handoff-bounded assignment evidence is still required.
+- `explicit-user-session` must not be widened to `explicit-session`; `explicit-participation` must not be converted into session or invocation authorization; `explicit-session` and `explicit-role-invocation` remain separate modes.
+- `Holder Relationship` must state what is known, what is unknown, and what must not be inferred when those limits matter.
+- `Holder Relationship` may reference relation, evidence, attestation, validation, privacy, source, access, resource, party, event, project, or instrument artifacts when those artifacts own companion semantics.
+
+### Interpretation Limits
+
+Required Fields
+
+- Does Not Prove
+- Must Not Be Treated As
+
+Optional Fields
+
+- Employment Limits
+- Consent Limits
+
+Rules
+
+- `Interpretation Limits` must remain human-readable and bounded.
+- `Interpretation Limits` must state what is known, what is unknown, and what must not be inferred when those limits matter.
+- `Interpretation Limits` may reference relation, evidence, attestation, validation, privacy, source, access, resource, party, event, project, or instrument artifacts when those artifacts own companion semantics.
+
+### Allowed Or Common Shapes
+
+Allowed Shapes
+
+- project lead
+- reviewer
+- maintainer
+- facilitator
+- witness
+- safety officer
+- resource owner
+- on-call role
+
+Rules
+
+- Allowed shapes are guidance for common reading and grouping, not an exhaustive vocabulary.
+- Local artifacts may use another precise human-readable shape when the declared boundaries remain clear.
+
+### File Naming
+
+Allowed Shapes
+
+- `<lineage>.trace.md`
+- `<lineage>-party-role.trace.md`
+- `<lineage>-<party-role-slug>.trace.md`
+
+Rules
+
+- Artifacts should keep the lineage label first.
+- The optional slug should describe the bounded artifact role rather than a low-signal implementation detail.
+- Ordinary lineage artifacts should keep the `.trace.md` suffix stable.
+
+### Interpretation Boundaries
+
+Rules
+
+- Use `tiinex.party.role.v1` when the main artifact value is the declared party role role.
+- Do not use `tiinex.party.role.v1` to replace evidence, attestation, validation, consent, relation, task, decision, event, party, resource, or instrument artifacts when those schemas own the main role.
+- Parent remains direct continuity ancestry; related targets should be represented through relation or target fields unless direct continuation is being declared.
+
+## Artifact Creation Contract
+
+### Creation Fields
+
+Required Fields
+
+- Role Label
+- Role Kind
+- In Scope
+- Out Of Scope
+- May Do
+- Does Not Authorize
+- Holder State
+- Assignment Modes
+- Does Not Prove
+- Must Not Be Treated As
+
+### Creation Rules
+
+Rules
+
+- Creation tools should keep the artifact human-readable and bounded.
+- Creation tools creating or revising a current `tiinex.party.role.v1` artifact must emit `Assignment Modes` directly in `Holder Relationship`; they must not substitute `Holder State` prose, a Decision-side legacy mapping, filename identity, or Tooling-local compatibility data.
+- Creation tools should serialize multiple Assignment Modes as plain canonical tokens separated by `, ` in canonical token order and should reject aliases, duplicate tokens, unknown tokens, code-span quoting, and arbitrary prose in that field.
+- Creation tools should preserve unknown, partial, contested, private, unsafe, unavailable, or ambiguous state instead of inventing certainty. When holder-assignment authorization is unresolved, the artifact must not be treated as authorizing a bounded holder merely because `Holder State` prose appears familiar.
+## Minimal Example
+
+```md
+# Party Role Example
+
+## Role Identity
+
+- Role Label: bounded example for tiinex.party.role.v1
+- Role Kind: bounded example for tiinex.party.role.v1
+
+## Role Boundary
+
+- In Scope: bounded example for tiinex.party.role.v1
+- Out Of Scope: bounded example for tiinex.party.role.v1
+
+## Authority And Responsibility Boundary
+
+- May Do: bounded example for tiinex.party.role.v1
+- Does Not Authorize: bounded example for tiinex.party.role.v1
+
+## Holder Relationship
+
+- Holder State: bounded example for tiinex.party.role.v1
+- Assignment Modes: explicit-session, handoff
+
+## Interpretation Limits
+
+- Does Not Prove: truth, consent, authority, attendance, allocation, or final outcome by itself
+- Must Not Be Treated As: tiinex.party.role.v1 example must not be treated as proof outside its declared boundary
+```
+
+## Validation-Friendly Shape
+
+Keep this schema note in the exact section order already used here: `Summary`, `Schema Validation Contract`, `Artifact Creation Contract`, `Minimal Example`, `Validation-Friendly Shape`, and `Interpretation Notes`.
+
+Maintain the section headings exactly in this schema note. Free markdown inside those sections is allowed, but adding undeclared new section headings should be treated as schema drift.
+
+The body headings required for artifacts using this schema are: `## Role Identity`, `## Role Boundary`, `## Authority And Responsibility Boundary`, `## Holder Relationship`, `## Interpretation Limits`.
+
+## Interpretation Notes
+
+- role is not the person holding it
+- role does not prove authority unless authority is separately supported
+- `Assignment Modes` is the only current machine-authoritative holder-assignment representation in this schema revision; `Holder State` remains human-readable context
+- historical artifacts may remain auditable against the exact schema/source revision they originally declared, but historical compatibility does not create current holder-assignment authorization
+
+---
+
+# Continuity Integrity
+
+- sha256-base64url-c14n-v1
+  - Towards: [tiinex.party.v1.schema.md](https://github.com/Tiinex/docs/blob/2a40646640f7468bcd250df6988b69e9f047f1bb/.topics/.schemas/party/tiinex.party.v1.schema.md)
+  - Value: m-C4EsPECe8ZZ4rJ_99MlV5ougMsI_gIDtCCDk1MLWY
+
+- sha256-base64url-c14n-v2
+  - Towards: self
+  - Value: rA6BGI_Af8Ggy74sZGxtBXH9U9we0Q8f4GH19QsmT2U

package/src/schemas/party/role/tiinex.party.role.v1.schema.runtime.json

@@ -2,10 +2,10 @@
   "schema": "tiinex.site.schema-runtime-projection.v1",
   "generator": "schema-runtime-projection-v1",
   "schemaId": "tiinex.party.role.v1",
-  "sourceChecksum": "16b6bd63b9ba6044906aa9daa9bd289881171ddc875b3b9e7c2158470ad27828",
-  "sourceBlobSha": "16687051579d5c850591d4bf4e2dbd9705f83983",
-  "sourceBytes": 10364,
-  "bindingChecksum": "16b6bd63b9ba6044906aa9daa9bd289881171ddc875b3b9e7c2158470ad27828",
+  "sourceChecksum": "2887aef16cf827b78fe38c1a2ba97cb5820d79049729d2cf8696ecf1de828871",
+  "sourceBlobSha": "ba134b998fb3d04a59a3bd5cd951115ea272ebda",
+  "sourceBytes": 13216,
+  "bindingChecksum": "2887aef16cf827b78fe38c1a2ba97cb5820d79049729d2cf8696ecf1de828871",
   "validationContract": {
     "schema": "tiinex.site.compact-portable-validation-contract.v1",
     "schemaId": "tiinex.party.role.v1",
@@ -413,7 +413,8 @@
             "findings": []
           },
           "requiredFields": [
-            "Holder State"
+            "Holder State",
+            "Assignment Modes"
           ],
           "optionalFields": [
             "Current Holder",
@@ -426,7 +427,8 @@
               "sourceSchemaId": "tiinex.party.role.v1",
               "group": "Holder Relationship",
               "requiredFields": [
-                "Holder State"
+                "Holder State",
+                "Assignment Modes"
               ],
               "optionalFields": [
                 "Current Holder",
@@ -1996,6 +1998,7 @@
       "May Do",
       "Does Not Authorize",
       "Holder State",
+      "Assignment Modes",
       "Does Not Prove",
       "Must Not Be Treated As"
     ],
@@ -2066,6 +2069,15 @@
         "sourceSchemaId": "tiinex.party.role.v1",
         "requirement": "required"
       },
+      {
+        "input": "Assignment Modes",
+        "kind": "ordinary-field",
+        "section": "Holder Relationship",
+        "group": "Holder Relationship",
+        "field": "Assignment Modes",
+        "sourceSchemaId": "tiinex.party.role.v1",
+        "requirement": "required"
+      },
       {
         "input": "Does Not Prove",
         "kind": "ordinary-field",

package/src/schemas/party/role/tiinex.party.role.v1.validate.js

@@ -0,0 +1,36 @@
+const ASSIGNMENT_MODE_ORDER = Object.freeze([
+  'explicit-session',
+  'explicit-user-session',
+  'explicit-role-invocation',
+  'handoff',
+  'explicit-participation'
+]);
+const ASSIGNMENT_MODE_SET = new Set(ASSIGNMENT_MODE_ORDER);
+
+export function partyRoleValidate(artifact = {}) {
+  if (artifact?.envelope?.current?.schema?.id !== 'tiinex.party.role.v1') return [{ severity: 'warning', code: 'party.role.schema.mismatch', messageKey: 'party.role.schema.mismatch', message: 'Party Role validator invoked for a non-Role current schema.', source: 'tiinex.party.role.v1' }];
+  const section = sectionBody(String(artifact?.body?.text || ''), 'Holder Relationship');
+  const values = fieldValues(section, 'Assignment Modes');
+  if (values.length !== 1) return [{ severity: 'error', code: values.length ? 'party.role.assignmentModes.duplicate-field' : 'party.role.assignmentModes.missing', messageKey: values.length ? 'party.role.assignmentModes.duplicate-field' : 'party.role.assignmentModes.missing', message: values.length ? 'Holder Relationship must contain exactly one Assignment Modes field.' : 'Holder Relationship must declare Assignment Modes directly.', source: 'tiinex.party.role.v1', fixability: 'manual' }];
+  const raw = values[0];
+  if (!raw) return [{ severity: 'error', code: 'party.role.assignmentModes.empty', messageKey: 'party.role.assignmentModes.empty', message: 'Assignment Modes must contain at least one canonical assignment-mode token.', source: 'tiinex.party.role.v1', fixability: 'manual' }];
+  const tokens = raw.split(', ');
+  const canonical = tokens.length > 0
+    && tokens.every((token) => ASSIGNMENT_MODE_SET.has(token))
+    && new Set(tokens).size === tokens.length
+    && tokens.every((token, index) => index === 0 || ASSIGNMENT_MODE_ORDER.indexOf(tokens[index - 1]) < ASSIGNMENT_MODE_ORDER.indexOf(token))
+    && tokens.join(', ') === raw;
+  if (!canonical) return [{ severity: 'error', code: 'party.role.assignmentModes.invalid', messageKey: 'party.role.assignmentModes.invalid', message: `Assignment Modes must be plain canonical tokens separated by ", " in canonical order. Allowed values: ${ASSIGNMENT_MODE_ORDER.join(', ')}.`, source: 'tiinex.party.role.v1', fixability: 'manual', params: { field: 'Assignment Modes', allowedValues: ASSIGNMENT_MODE_ORDER.join(', ') } }];
+  return [{ severity: 'info', code: 'party.role.assignmentModes.canonical', messageKey: 'party.role.assignmentModes.canonical', message: 'Assignment Modes is present and canonical.', source: 'tiinex.party.role.v1', params: { field: 'Assignment Modes' } }];
+}
+
+function sectionBody(markdown = '', heading = '') {
+  const escaped = escapeRegExp(heading);
+  const match = String(markdown || '').match(new RegExp(`^##\\s+${escaped}\\s*$([\\s\\S]*?)(?=^##\\s+|\\Z)`, 'm'));
+  return match?.[1] || '';
+}
+function fieldValues(section = '', label = '') {
+  const escaped = escapeRegExp(label);
+  return [...String(section || '').matchAll(new RegExp(`^\\s*-\\s*${escaped}:\\s*(.*?)\\s*$`, 'gm'))].map((match) => match[1]);
+}
+function escapeRegExp(value = '') { return String(value).replace(/[.*+?^${}()|[\\]\\]/g, '\\$&'); }

package/src/schemas/schema.reference.js

@@ -106,6 +106,35 @@ function materialIdentitiesMatch(semantic = {}, resolved = {}) {
   return true;
 }
 
+
+export function qualifiedIdentifierOnlyHistoricalSchemaReferenceAuthority(schemaId = '', evidence = {}) {
+  const id = String(schemaId || '').trim();
+  if (!id) return Object.freeze({ schema: SCHEMA_REFERENCE_AUTHORITY_SCHEMA_ID, schemaId: '', exactTargets: Object.freeze([]), semanticSourceTargets: Object.freeze([]), materialBoundTarget: false, preferredTarget: '', targetAuthority: 'schema-id-only', resolutionState: 'unavailable', resolutionEvidence: Object.freeze({}), semanticMaterialIdentity: Object.freeze({ state: 'unavailable' }), exactSourceTargets: Object.freeze({ state: 'unavailable', targets: Object.freeze([]), findings: Object.freeze(['Historical schema identifier is unavailable.']) }), historicalReferenceAuthority: Object.freeze({ state: 'unavailable', kind: 'identifier-only', exactRevisionState: 'unresolved', evidence: Object.freeze({ ...evidence }) }) });
+  return Object.freeze({
+    schema: SCHEMA_REFERENCE_AUTHORITY_SCHEMA_ID,
+    schemaId: id,
+    exactTargets: Object.freeze([]),
+    semanticSourceTargets: Object.freeze([]),
+    materialBoundTarget: false,
+    preferredTarget: '',
+    targetAuthority: 'schema-id-only',
+    resolutionState: 'qualified',
+    resolutionEvidence: Object.freeze({ state: 'qualified', kind: 'historical-declared-schema-identifier-only', schemaId: id, ...evidence }),
+    semanticMaterialIdentity: Object.freeze({ state: 'unavailable', schemaId: id }),
+    exactSourceTargets: Object.freeze({ state: 'unavailable', targets: Object.freeze([]), findings: Object.freeze(['No exact historical schema representation target is declared or independently qualified.']) }),
+    historicalReferenceAuthority: Object.freeze({ state: 'qualified', kind: 'identifier-only', exactRevisionState: 'unresolved', evidence: Object.freeze({ ...evidence }) })
+  });
+}
+
+export function isQualifiedIdentifierOnlyHistoricalSchemaReferenceAuthority(authority = {}) {
+  return String(authority?.resolutionState || authority?.state || '') === 'qualified'
+    && String(authority?.targetAuthority || '') === 'schema-id-only'
+    && String(authority?.historicalReferenceAuthority?.kind || '') === 'identifier-only'
+    && String(authority?.historicalReferenceAuthority?.exactRevisionState || '') === 'unresolved'
+    && !String(authority?.preferredTarget || authority?.target || '').trim()
+    && !(authority?.exactTargets || []).some((item) => String(item || '').trim());
+}
+
 export function parseSchemaReferenceValue(value = '') {
   const raw = String(value ?? '');
   if (!raw) return Object.freeze({ raw: '', form: 'empty', schemaId: '', target: '' });

package/src/tooling/portable/adapters/cli/cli.command-input.js

@@ -117,7 +117,7 @@ export async function commandInput(parsed, runtime = {}) {
         packageSourcePath: packagePath,
         includeLegacyTopics: Boolean(flags['include-legacy-topics']),
         includeRequiredContext: flags['include-required-context'] || '',
-        holderBinding: { roleLabel: flags['holder-role'] || '', holderId: flags['holder-id'] || '' },
+        holderBinding: { roleLabel: flags['holder-role'] || '', holderId: flags['holder-id'] || '', sourceLocator: holderBindingCliSource(flags) },
         host,
         recoveryAcceptance
       },
@@ -471,4 +471,11 @@ function mergeLoadedMaterial(primary = {}, secondary = {}) {
 }
 
 function normalizeRuntimePaths(value) { const paths = Array.isArray(value) ? value : value ? [value] : []; return paths.map((entry) => String(entry || '').trim()).filter(Boolean); }
+function holderBindingCliSource(flags = {}) {
+  const fields = [];
+  if (Object.prototype.hasOwnProperty.call(flags, 'holder-role')) fields.push('--holder-role');
+  if (Object.prototype.hasOwnProperty.call(flags, 'holder-id')) fields.push('--holder-id');
+  return fields.length ? `cli:${fields.join(',')}` : '';
+}
+
 function splitFlag(value) { return !value || value === true ? [] : String(value).split(',').map((item) => item.trim()).filter(Boolean); }