@tiinex/app 0.1.1

package/src/tooling/portable/package/fixtures/reference-relation-generation-authority.trace.md

@@ -0,0 +1,84 @@
+# Continuity Context
+
+- Envelope Schema: tiinex.root.v1
+- Current
+  - Current Schema: tiinex.schema.generation.v1
+  - Created At: 2026-08-19 00:00:00
+  - Summary: Portable generation authority fixture for one durable Relation draft.
+
+---
+
+# Reference Relation Generation Authority
+
+## Generation Identity
+
+- Generation Handle: reference-relation-draft
+- Generation Name: Reference relation draft generation
+- Generation Kind: artifact-filled
+
+## Generation Target
+
+- Target Schema: tiinex.relation.v1
+- Target Output: full Relation artifact draft
+
+## Required Inputs
+
+- Subject Binding
+  - Input Source Policy: imported-input
+  - Unknown Handling: mark-unknown
+
+- Predicate Identifier
+  - Input Source Policy: imported-input
+  - Unknown Handling: mark-unknown
+
+- Predicate Meaning
+  - Input Source Policy: imported-input
+  - Unknown Handling: mark-unknown
+
+- Object Binding
+  - Input Source Policy: imported-input
+  - Unknown Handling: mark-unknown
+
+- Directionality
+  - Input Source Policy: imported-input
+  - Unknown Handling: mark-unknown
+
+## Generation Steps
+
+- create-relation-declaration
+  - Step Action: create-section
+  - Step Order: 10
+  - Uses Section Contract: relation-declaration
+
+- create-relation-target
+  - Step Action: create-section
+  - Step Order: 20
+  - Uses Section Contract: relation-target
+
+- preserve-reference-meaning
+  - Step Action: fill-value
+  - Step Order: 30
+  - Review Needed: yes
+
+- preserve-relation-boundary
+  - Step Action: add-limit
+  - Step Order: 40
+  - Review Needed: yes
+
+## Output Boundary
+
+- Output Kind: filled-draft
+- Review State: unreviewed draft
+- Mutation Policy: local-draft-only
+- Save Policy: caller-owned
+
+## Interpretation Limits
+
+- Does Not Mean: Tooling authorizes Reference execution or invents predicate, Parent, placement, provenance, or relation truth.
+- Must Not Be Used To Claim: the Relation draft is validated, reviewed, persisted, published, or semantically authorized beyond the supplied Transition and generation authorities.
+
+# Continuity Integrity
+
+- sha256-base64url-c14n-v2
+  - Towards: self
+  - Value: test-fixture-not-canonical

package/src/tooling/portable/package/fixtures/tiinex.root.v1.package-authority.contract-fixture.md

@@ -0,0 +1,64 @@
+<!-- Contract-only pressure fixture from canonical Root authority lineage through docs@053d46ce. -->
+# Continuity Context
+
+- Envelope Schema: tiinex.root.v1
+- Current
+  - Current Schema: tiinex.root.v1
+  - Created At: 2026-08-17 00:00:00
+
+---
+
+# Root
+
+## Schema Validation Contract
+
+### Ordinary Instance Field Targeting
+
+Rules
+
+- An ordinary instance-field group declares `Required Fields` and/or `Optional Fields`, does not declare `Entry Shape`, and uses ordinary unqualified field labels.
+- Unless an ordinary instance-field group declares `Instance Target`, its Artifact instance target is the exact second-level heading whose text equals the contract group name.
+- Ordinary field occurrences are owned only by their authorized target block. Fields inside a nested heading or named-declaration-owned region are not claimed by an ancestor ordinary group merely because the label matches.
+
+### Instance Target
+
+Required Shape
+
+- one literal Markdown heading token
+
+Rules
+
+- `Instance Target` is singular; it must not be used as a list of multiple Artifact targets.
+- Heading text is interpreted using Root exact, case-sensitive heading matching.
+- `Instance Target` changes field-ownership location only; it does not make an otherwise optional target section required.
+
+### Machine Shape Authority
+
+Entry Shape
+
+- Named Declaration
+
+Declaration Fields
+
+- Grammar Profile
+- Start Rule
+- Grammar Rule
+- Human Meaning
+
+Machine Shape Definitions
+
+- Markdown Link
+  - Grammar Profile: tiinex.lexical.shape.v1
+  - Start Rule: markdown-link
+  - Grammar Rule: markdown-link = "[" label "](" target ")"
+  - Grammar Rule: label = ANY-EXCEPT("]", TAB, CR, LF)+
+  - Grammar Rule: target = ANY-EXCEPT(")", SPACE, TAB, CR, LF)+
+  - Human Meaning: Exactly one complete inline Tiinex Markdown link with a non-empty single-line label and non-empty target.
+
+Rules
+
+- Machine-shape definitions are resolved by lineage prefix at the source point of the shape use.
+- Source order inside one schema is not semantic.
+- Duplicate exact-label definitions are not deduplicated.
+- Human Meaning is explanatory readability authority only.
+- tiinex.lexical.shape.v1 is the Root-owned generic lexical grammar profile.

package/src/tooling/portable/package/fixtures/tiinex.schema.generation.v1.generation-binding.contract-fixture.md

@@ -0,0 +1,140 @@
+<!-- Contract-only fixture transcribed from Tiinex/docs@053d46ce082d4ec261b82abc44ecca403d61e240. Bare scalar syntax from the non-authoritative Minimal Example is intentionally not imported as validation authority. -->
+# Continuity Context
+
+- Envelope Schema: tiinex.root.v1
+- Parent
+  - Parent Schema: tiinex.schema.contract.v1
+  - Trace: parent.trace.md
+  - Origin: parent.trace.md
+- Current
+  - Current Schema: tiinex.schema.generation.v1
+  - Created At: 2026-08-16 00:00:00
+
+---
+
+# Schema Generation
+
+## Schema Validation Contract
+
+### Generation Body
+
+Required Shape
+
+- first body heading after the continuity envelope
+- `## Generation Identity` section
+- `## Generation Target` section
+- `## Required Inputs` section
+- `## Generation Steps` section
+- `## Output Boundary` section
+- `## Interpretation Limits` section
+
+### Generation Identity
+
+Required Fields
+
+- Generation Handle
+- Generation Name
+- Generation Kind
+
+Optional Fields
+
+- Generation Version
+- Generation Owner
+- Generation Mode
+
+### Generation Target
+
+Required Fields
+
+- Target Schema
+- Target Output
+
+Optional Fields
+
+- Target Artifact Kind
+- Target Section Contracts
+- Target Field Contracts
+- Target Rule Contracts
+- Parent Schema
+- Child Schema
+
+### Required Inputs
+
+Entry Shape
+
+- First-Level Hyphen List Item
+
+Required Fields
+
+- Input Source Policy
+
+Optional Fields
+
+- Optional Input
+- Derived Input
+- Defaultable Input
+- User Prompt
+- Adapter Source
+- LLM Assistance Allowed
+- Unknown Handling
+
+Rules
+
+- Each first-level entry is one required-input declaration.
+- The declaration name is the readable Required Input identity and must be unique within `## Required Inputs`.
+- Each input entry owns its own `Input Source Policy`; source policy must not be paired by list position or document-wide field order.
+
+### Generation Steps
+
+Entry Shape
+
+- First-Level Hyphen List Item
+
+Required Fields
+
+- Step Action
+
+Optional Fields
+
+- Step Order
+- Uses Section Contract
+- Uses Field Contract
+- Uses Rule Contract
+- Uses Value Contract
+- Condition
+- On Missing Input
+- Review Needed
+
+Rules
+
+- Each first-level entry is one generation-step declaration.
+- The declaration name is the existing readable `Step Handle` identity and must be unique within `## Generation Steps`.
+- Step-local fields belong to that declaration; validators must not pair repeated Step Action/Order values by document position.
+
+### Output Boundary
+
+Required Fields
+
+- Output Kind
+- Review State
+
+Optional Fields
+
+- Completeness Boundary
+- Validation Boundary
+- Placeholder Policy
+- Mutation Policy
+- Save Policy
+
+### Interpretation Limits
+
+Required Fields
+
+- Does Not Mean
+- Must Not Be Used To Claim
+
+Optional Fields
+
+- Overclaim Risk
+- Missing Input Risk
+- Review Boundary

package/src/tooling/portable/package/fixtures/tiinex.schema.transition.companion.v1.contract-fixture.md

@@ -0,0 +1,73 @@
+<!-- Contract-only pressure fixture transcribed from Tiinex/docs@053d46ce. -->
+# Continuity Context
+
+- Envelope Schema: tiinex.root.v1
+- Parent
+  - Parent Schema: tiinex.root.v1
+  - Trace: root.md
+  - Origin: root.md
+- Current
+  - Current Schema: tiinex.schema.transition.companion.v1
+  - Created At: 2026-08-17 00:00:00
+
+---
+
+# Schema Transition Companion
+
+## Schema Validation Contract
+
+### Schema Transition Companion Body
+
+Required Shape
+
+- `## Schema Binding` section
+- `## Transition Attachments` section
+- `## Interpretation Limits` section
+
+### Schema Binding
+
+Required Fields
+
+- Schema Reference
+
+Optional Fields
+
+- Note
+
+Field Value Constraints
+
+- Schema Reference
+  - Allowed Shape: Markdown Link
+  - Domain Policy: closed
+
+### Transition Attachment Declaration
+
+Entry Shape
+
+- First-Level Hyphen List Item
+
+Required Fields
+
+- Transition Reference
+
+Optional Fields
+
+- Note
+
+Field Value Constraints
+
+- Transition Reference
+  - Allowed Shape: Markdown Link
+  - Domain Policy: closed
+
+Rules
+
+- Entries under `## Transition Attachments` are repeated named declarations using this shape.
+- The literal entry `none` is allowed only as the sole `## Transition Attachments` entry and is exempt from declaration fields.
+
+### Interpretation Limits
+
+Required Fields
+
+- Does Not Mean
+- Must Not Be Used To Claim

package/src/tooling/portable/package/fixtures/tiinex.semantic.package.v1.contract-fixture.md

@@ -0,0 +1,147 @@
+<!-- Contract-only pressure fixture transcribed from Tiinex/docs@053d46ce. -->
+# Continuity Context
+
+- Envelope Schema: tiinex.root.v1
+- Parent
+  - Parent Schema: tiinex.root.v1
+  - Trace: root.md
+  - Origin: root.md
+- Current
+  - Current Schema: tiinex.semantic.package.v1
+  - Created At: 2026-08-17 00:00:00
+
+---
+
+# Semantic Package Manifest
+
+## Schema Validation Contract
+
+### Semantic Package Body
+
+Required Shape
+
+- `## Package Identity` section
+- `## Package Boundary` section
+- `## Included Packages` section
+- `## External Package Dependencies` section
+- `## Schema Resolution Bindings` section
+- `## Interpretation Limits` section
+
+### Package Identity
+
+Required Fields
+
+- Package Name
+- Purpose
+
+Optional Fields
+
+- Package Handle
+- Package Version
+- Notes
+
+### Package Boundary
+
+Required Fields
+
+- Boundary Root
+- Discovery Policy
+- Nested Package Policy
+
+Field Value Constraints
+
+- Boundary Root
+  - Allowed Value: manifest-directory
+  - Domain Policy: closed
+- Discovery Policy
+  - Allowed Value: recursive-within-boundary
+  - Domain Policy: closed
+- Nested Package Policy
+  - Allowed Value: explicit-only
+  - Domain Policy: closed
+
+### Included Package Declaration
+
+Entry Shape
+
+- First-Level Hyphen List Item
+
+Required Fields
+
+- Package Reference
+
+Optional Fields
+
+- Note
+
+Field Value Constraints
+
+- Package Reference
+  - Allowed Shape: Markdown Link
+  - Domain Policy: closed
+
+Rules
+
+- Entries under `## Included Packages` are repeated named declarations using this shape.
+- The literal entry `none` is allowed only as the sole `## Included Packages` entry and is exempt from declaration fields.
+
+### External Package Dependency Declaration
+
+Entry Shape
+
+- First-Level Hyphen List Item
+
+Required Fields
+
+- Package Reference
+
+Optional Fields
+
+- Note
+
+Field Value Constraints
+
+- Package Reference
+  - Allowed Shape: Markdown Link
+  - Domain Policy: closed
+
+Rules
+
+- Entries under `## External Package Dependencies` are repeated named declarations using this shape.
+- The literal entry `none` is allowed only as the sole `## External Package Dependencies` entry and is exempt from declaration fields.
+
+### Schema Resolution Binding Declaration
+
+Entry Shape
+
+- First-Level Hyphen List Item
+
+Required Fields
+
+- Schema Reference
+
+Optional Fields
+
+- Package Reference
+- Note
+
+Field Value Constraints
+
+- Schema Reference
+  - Allowed Shape: Markdown Link
+  - Domain Policy: closed
+- Package Reference
+  - Allowed Shape: Markdown Link
+  - Domain Policy: closed
+
+Rules
+
+- Entries under `## Schema Resolution Bindings` are repeated named declarations using this shape.
+- The literal entry `none` is allowed only as the sole `## Schema Resolution Bindings` entry and is exempt from declaration fields.
+
+### Interpretation Limits
+
+Required Fields
+
+- Does Not Mean
+- Must Not Be Used To Claim

package/src/tooling/portable/package/fixtures/tiinex.transition.definition.v1.package-contract-fixture.md

@@ -0,0 +1,77 @@
+<!-- Minimal generic Transition read pressure fixture; Transition behavior remains canonical elsewhere. -->
+# Continuity Context
+
+- Envelope Schema: tiinex.root.v1
+- Parent
+  - Parent Schema: tiinex.root.v1
+  - Trace: root.md
+  - Origin: root.md
+- Current
+  - Current Schema: tiinex.transition.definition.v1
+  - Created At: 2026-08-17 00:00:00
+
+---
+
+# Transition Definition
+
+## Schema Validation Contract
+
+### Transition Body
+
+Required Shape
+
+- `## Transition Identity` section
+- `## Input Roles` section
+- `## Output Roles` section
+
+### Transition Identity
+
+Required Fields
+
+- Name
+- Version
+- Canonical Identifier
+
+### Input Role Declaration
+
+Entry Shape
+
+- First-Level Hyphen List Item
+
+Required Fields
+
+- Meaning
+- Minimum Count
+- Maximum Count
+
+Optional Fields
+
+- Target Kind
+- Schema Constraint
+
+Rules
+
+- Entries under `## Input Roles` are repeated named declarations using this shape.
+- The literal entry `none` is allowed only as the sole `## Input Roles` entry and is exempt from declaration fields.
+
+### Output Role Declaration
+
+Entry Shape
+
+- First-Level Hyphen List Item
+
+Required Fields
+
+- Meaning
+- Minimum Count
+- Maximum Count
+
+Optional Fields
+
+- Target Kind
+- Schema Constraint
+
+Rules
+
+- Entries under `## Output Roles` are repeated named declarations using this shape.
+- The literal entry `none` is allowed only as the sole `## Output Roles` entry and is exempt from declaration fields.

package/src/tooling/portable/providers/schema.providers.genericity.case.mjs

@@ -0,0 +1,31 @@
+import assert from 'node:assert/strict';
+import { resolvePortableSchemaMaterial } from '@tiinex/core/tooling/portable/providers/schema.providers.js';
+
+const generic = await resolvePortableSchemaMaterial({ schemaId: 'example.schema.v1' }, {});
+assert.equal(generic.providerRequest.repository, '', 'generic provider requests must not invent a project repository');
+assert.equal(generic.providerRequest.ref, '', 'generic provider requests must not invent a project ref');
+assert.equal(generic.providerRequest.capability, 'supply-schema-material', 'repository action is unavailable without an explicit repository source');
+
+let observed = null;
+await resolvePortableSchemaMaterial({
+  schemaId: 'example.schema.v1',
+  sourceProfile: { repository: 'Acme/specs', ref: 'stable' }
+}, {
+  providers: [{
+    id: 'capture',
+    resolveSchema: async (request) => { observed = request; return null; }
+  }]
+});
+assert.equal(observed.repository, 'Acme/specs');
+assert.equal(observed.ref, 'stable');
+
+const overridden = await resolvePortableSchemaMaterial({
+  schemaId: 'example.schema.v1',
+  repository: 'Operator/schemas',
+  ref: 'review',
+  sourceProfile: { repository: 'Acme/specs', ref: 'stable' }
+}, {});
+assert.equal(overridden.providerRequest.repository, 'Operator/schemas');
+assert.equal(overridden.providerRequest.ref, 'review');
+
+console.log('✓ schema provider genericity regression: project source is explicit profile/operator data only');