Principle-Framework Publication Integration and Preservation

About this pattern

This is a generated FPF pattern page projected from the published FPF source. It is canonical FPF content for this ID; it is not a FPF Reference product feature page.

How to use this pattern

Read the ID, status, type, and normativity first. Use the content for exact wording, the relations for adjacent concepts, and citations to keep active work grounded without pasting the whole specification.

Type: Method pattern Status: Draft Normativity: Normative unless explicitly marked informative

Use this pattern when accepted changes are being assembled into a candidate FPF, DPF, or LPF publication and the maintainer must answer either of two questions:

Relations

E.4.PFIPcoordinates withMulti‑View Publication Kit
E.4.PFIPcoordinates withEvidence Graph Referring (C-4)
E.4.PFIPoutline parentFPF Ecosystem Family Architecture
E.4.PFIPexplicit referenceFPF Authoring Conventions & Style Guide
E.4.PFIPexplicit referenceMulti‑View Publication Kit
E.4.PFIPexplicit referenceEvidence Graph Referring (C-4)

Content

Problem frame

Use this pattern when accepted changes are being assembled into a candidate FPF, DPF, or LPF publication and the maintainer must answer either of two questions:

  1. Did the candidate faithfully incorporate every accepted source contribution?
  2. Did the candidate preserve the useful content and selected structure of the predecessor publication outside accepted changes?

Use it especially when a publication form is replaced, split, merged, added, retired, or assigned another bounded use. A clean build, matching source files, or a readable candidate cannot answer the second question.

The primary working reader is a framework maintainer or integrator preparing one candidate publication. The primary EntityOfConcern is one candidate FPF, DPF, or LPF edition being assembled for one declared publication use. The method returns a preservation conclusion about that edition; files and build results are construction means or evidence rather than the edition being assessed.

First useful move. Name the candidate framework edition and publication use, identify every accepted source contribution for this candidate, and list the predecessor and candidate publication-form expressions whose continuity or change is claimed. Then select the source-to-candidate comparison and the applicable predecessor-preservation branch.

The first useful result is a bounded preservation conclusion. It names losses, repairs, accepted content changes or retirements, unexpected additions, blockers, and unresolved correspondences or content decisions. Ordinary retained content needs no positive prose row, but the complete comparison must remain checkable.

What this buys. An accepted change can be incorporated without erasing unrelated predecessor content, and a changed publication form can be assessed without confusing form, carrier, edition, or content.

Not this pattern when. Use E.8 to author one pattern, E.24.PUB to identify publication, expression, and bearing relations, E.17 to select reader-facing forms, E.11 to design the public entry, E.4.DPF.DA to evaluate a DPF or LPF package, and E.2.DA to evaluate whole-FPF adequacy. A responsible maintainer uses the local construction and release methods for repository operations and decisions to accept, admit, release, or land a publication. A new publication with no predecessor uses only the accepted-source comparison, complete candidate inventory, and applicable package evaluation.

Problem

Framework integration has two independent failure modes.

First, an accepted source contribution may never reach the candidate, or it may reach the wrong public entry or consumer. Second, the candidate may contain every accepted addition while silently losing useful predecessor content that no accepted decision changed. The source-to-candidate comparison can detect the first failure and cannot answer the second.

Publication plurality makes the second failure harder to see:

  • one framework edition can be exposed through a sequential monolith, extracted pattern texts, reader-entry and Preface forms, cards, diagrams, or retrieval forms;
  • two forms can serve the same broad use without being versions of one another;
  • a text diff can expose changed sentences but not a lost diagram relation, card field, retrieval cue, or admitted operation;
  • splitting or merging forms can make a predecessor form disappear even though its content still needs a disposition; and
  • a carrier can remain byte-identical while its selected edition, bounded use, or expression relation changes.

The recurring mistake is to use one visible proxy — source parity, build success, carrier continuity, heading coverage, or textual similarity — as proof that the complete predecessor publication survived.

Forces

ForceTension
Accepted change vs predecessor continuityThe candidate must realize new decisions without treating all other predecessor content as disposable.
Complete traversal vs affordable useEvery predecessor content or selected structure required for the declared use needs an outcome, but ordinary retained content should not create a large positive ledger.
Several forms vs truthful comparisonThe same edition may have several forms, yet shared use or shared carriers do not make those forms one eligible comparison pair.
Text convenience vs structural meaningLine and span diffs are cheap for comparable text; diagrams, cards, and retrieval forms need their own content or selected-structure inventories.
Form evolution vs content dispositionA form can be retired, split, or merged without authorizing the retirement of what it expressed.
Reuse vs local specificityFPF, DPF, and LPF publications share the integration problem, while an applicable FPF pattern still defines or constrains what matters for each form and use.
Strong assurance vs bounded resultThe comparison can expose loss and support later reliance; later admission, publication, release, or assurance decisions use their own methods.

Solution

Run two independent comparisons over one candidate framework publication:

  • accepted source to candidate: whether each accepted source contribution was incorporated into the named part of a candidate publication-form expression without changing its accepted meaning or use; and
  • predecessor to candidate: whether the candidate preserves the complete predecessor publication outside accepted content changes.

The predecessor-to-candidate question has two branches. Use a one-to-one expression comparison for an eligible predecessor/candidate pair. Use an allocation comparison for a non-one-to-one publication-form change, including every split or merge even when a narrower one-to-one pair also survives.

These two comparisons and the two predecessor branches are parts of the method, not new FPF kinds. When a later use needs the conclusion as a reusable episteme, identify it under C.2.1 and state the later reliance separately.

Bound the candidate and accepted inputs

Identify:

  • the candidate FPF, DPF, or LPF edition and declared publication use;
  • every accepted source contribution included in this candidate edition;
  • every candidate PublicationFormExpressionRelation occurrence and its selected edition, publication form, and bounded-use declaration;
  • the corresponding carriers and publication occurrences only when their identities affect the comparison; and
  • every predecessor expression whose continuity, replacement, retirement, split, merge, or use change is claimed.

Complete the accepted input set before assembly. If one source contribution changes a public entry, required input, result, field meaning, action order, stop, return, or another consumed interface, either include the affected public entries and direct consumers in this candidate or leave that contribution out until they can be updated with it.

For each accepted source contribution, record the candidate publication-form expression and the passage, field, relation, cue, or selected structure intended to incorporate it. A source contribution with no corresponding predecessor content is an accepted addition. Changing or retiring predecessor content needs an accepted content decision; changing or retiring a publication form is not such a decision.

Use E.24.PUB to keep the framework edition, publication form, expression relation, carrier, bearing relation, audience, bounded use, and publication occurrence distinct. Use the smallest explicit statement that supports the comparison.

Compare accepted sources with candidate expressions

After assembly, inspect every accepted source contribution in the named part of its candidate publication-form expression.

For each contribution, ask whether the candidate preserves the selected claim, action, result, boundary, relation, structure, or other content that made the contribution acceptable. Classification by filename, heading, or copied wording is insufficient when the receiving use changed.

Classify each accepted source contribution with one of these outcomes:

  • incorporated as accepted;
  • incorporated with an accepted content change;
  • missing or only partly incorporated;
  • placed where the intended reader or consumer cannot use it; or
  • blocked because the accepted source contribution or intended candidate expression part cannot be recovered.

The checkable traversal can retain an ordinary positive classification without adding a prose row. This comparison establishes source carry-through only. It says nothing yet about unrelated predecessor content.

Compare one eligible expression pair

One preservation comparison follows one eligible pair: one predecessor PublicationFormExpressionRelation occurrence and one candidate occurrence.

A pair is eligible only when both expressions have the same declared bounded use and either:

  • retain publication-form identity under the FPF pattern that defines or constrains that form; or
  • are identified by an accepted one-to-one replacement or continuity decision.

The same broad use alone does not pair two forms when several forms serve that use.

Before concluding preservation, select one complete, form-appropriate comparison inventory. The inventory names every predecessor claim, instruction, boundary, field, relation, cue, or selected structure required for the declared use. Beside each entry, record why it matters—the FPF pattern that defines or constrains the form, or another accepted comparison basis—and any candidate correspondence. The inventory is a comparison aid; it does not make the named kinds members of one new kind.

For comparable text expressions, deletion and replacement spans expose independently actionable predecessor claims, instructions, and boundaries. Treat this as one comparison technique, not the definition of completeness. For a card, diagram, retrieval form, or another expression without shared span coordinates, inventory the claims or selected structures required for the declared use. Use the FPF pattern that defines or constrains that form and, when applicable, C.33 to state captured and lost structure or C.34 to state a bounded structural correspondence.

Traverse the entire predecessor inventory. For each named content or selected structure, record one outcome:

  • matched by content or selected structure in one or more named candidate expression parts;
  • intentionally changed or retired by an accepted content decision;
  • accidentally lost; or
  • blocked because the correspondence or decision cannot be established.

Classify candidate content or selected structure without a predecessor correspondence as an accepted or unexpected addition. If no applicable FPF pattern or accepted comparison basis makes a complete inventory selectable for the declared use, stop at missing form-comparison basis. Carrier identity, visual similarity, or a green build cannot complete the comparison.

Allocate a non-one-to-one form change

An accepted publication-form addition, retirement, split, merge, or use-change decision names the affected predecessor and candidate expression occurrences and any narrower one-to-one continuity that survives. It authorizes the change in publication forms. It does not dispose of predecessor content.

Run a separate allocation comparison for every accepted form change that leaves an affected predecessor expression outside an eligible one-to-one pair, and for every split or merge even when narrower pairs survive.

  1. Select a complete inventory for every predecessor expression named by the form-change decision.
  2. For every named predecessor content or selected structure, record one or more corresponding candidate expression parts, an accepted content-change or content-retirement decision, an accidental-loss result, or a blocker.
  3. Allow predecessor content to appear in several candidate expressions and several predecessor inventory entries to correspond to one candidate expression part.
  4. Inspect the complete inventories of the named candidate expressions and classify candidate content or selected structure without a predecessor allocation as accepted or unexpected additions.
  5. Reuse an eligible-pair result as correspondence evidence when applicable, but do not let it replace the allocation traversal.

Keep every named expression, carrier, edition, and publication occurrence separate throughout the allocation. The allocation comparison is the method for reasoning across them; it does not need a new collective publication kind.

Without the form-change decision, stop at missing publication-expression continuity decision. Without a complete selectable predecessor inventory, stop at missing form-comparison basis. Without an outcome for any named predecessor content or selected structure, return accidental loss or a blocker. Retiring a form never retires its content by implication.

Complete the affected-publication comparison and return

Identify every affected publication-form expression relation occurrence and, when carrier or publication identity affects the comparison, its bearing and publication relations. Run every applicable eligible-pair comparison and allocation comparison. Check each shared public entry or direct consumer once across the comparisons, while preserving the separate expression results that depend on it.

Return a bounded preservation conclusion with:

  • accidental losses and the expression parts that need repair;
  • accepted content changes or retirements that account for a predecessor difference;
  • unexpected additions;
  • unresolved candidate correspondences or content-change questions;
  • blockers and the comparisons they prevent; and
  • the declared use for which the conclusion holds.

The complete traversal remains checkable even though unchanged predecessor content and selected structure receive no prose rows. A build result, successful accepted-source comparison, pattern-quality result, or package-adequacy result cannot substitute for it.

When the framework publication has no predecessor, perform the accepted-source comparison, inspect the complete candidate inventory, check changed public entries and direct consumers, and use the applicable package evaluation. When an unchanged edition is merely republished through a different form or carrier, use E.24.PUB, E.17, C.33, and C.34 for the changed publication claims. Use this pattern only when accepted-source integration or complete framework-publication continuity is the live problem.

Archetypal Grounding

Tell — one-to-one text revision. A DPF maintainer adds an accepted pattern and updates one existing pattern. The source-to-candidate comparison confirms both changes. A text comparison with the predecessor monolith then finds an unrelated non-use boundary deleted during paragraph cleanup. That boundary has no accepted retirement decision, so the preservation conclusion reports accidental loss even though the build and accepted-source comparison are clean.

Show — one form split into two. One predecessor pattern-text form is split into two candidate forms. The accepted split decision names all three expressions. The complete predecessor inventory allocates a shared working-situation claim to both candidates, three predecessor claims to one candidate pattern card, and one obsolete tool instruction to an accepted content-retirement decision. A predecessor non-use warning appears in neither candidate. Retiring the old form does not retire the warning, so the missing line blocks preservation until the warning is restored or its content change or retirement is accepted.

Show — architecture diagram. One FPF architecture-diagram form is replaced one-to-one by a candidate diagram for the same orientation use. The diagrams have no useful line diff. The maintainer uses the FPF pattern that defines or constrains that diagram form to select named framework parts, dependency edges, and legend distinctions for the inventory. The maintainer uses C.33 to record captured and lost structure and C.34 to record the declared correspondence. One predecessor dependency edge has no candidate correspondent, so similar layout cannot support a positive conclusion.

Show — local practice framework. An LPF candidate replaces a repeated general explanation with a reference to a new FPF method. The accepted-source comparison passes. The predecessor comparison still checks the LPF's local recovery cue, concrete work-size limit, and tool-specific stop because the general FPF method does not include those local actions. Removing them would be loss, not successful deduplication.

Bias-Annotation

Scope: Limited to accepted-source integration and predecessor continuity for FPF, DPF, and LPF publication expressions. The complete-traversal rule applies across text, diagrams, cards, retrieval forms, and split or merged publications only when a selectable inventory and feasible semantic inspection exist for the declared use. It is not a universal software-merge, data-migration, or digital-preservation method.

LensLikely driftRepair
GovSource parity, a green build, or an accepted form change is read as permission to change or retire predecessor content.Require an accepted content-change or content-retirement decision for that disposition. Keep the preservation conclusion as comparison evidence, not acceptance, release, landing, or assurance authority.
ArchEdition, form, expression relation, carrier, and publication occurrence collapse into one file or bundle, so a surviving carrier is treated as surviving content.Keep the objects distinct; use eligible expression pairs for one-to-one continuity and allocation comparisons for every split or merge.
Onto-EpistA selected inventory is treated as complete knowledge of the publication because filenames, headings, or visible text were covered.Select the inventory through the applicable FPF pattern or another accepted basis for the declared use. Return missing form-comparison basis when no complete inventory can be selected.
PragComplete traversal grows into a written positive ledger, or cost pressure turns one proxy into preservation proof.Traverse every inventory entry, reuse shared evidence, and write only losses, accepted changes or retirements that explain a difference, unexpected additions, blockers, and unresolved questions.
DidRetained content without a prose row looks unchecked, so reviewers ask for duplicate status text instead of inspecting the traversal boundary.State once that the complete inventory is checkable and ordinary retained entries need no prose rows; use the unlike worked cases to teach where a separate result is required.

The external source traditions below come mainly from software transformation, merge analysis, and digital preservation. They make semantic and form-specific comparison visible, but they do not make a principle framework into software or an archival object. The applicable FPF pattern defines or constrains what matters for each form, and the maintainer selects the inventory for the declared publication use.

Conformance Checklist

CheckPassing condition
CC-PFIP-1 Bounded candidateThe candidate framework edition and declared publication use are named.
CC-PFIP-2 Accepted inputs completeEvery accepted source contribution is included; when it changes a public entry or consumed interface, the affected public entries and direct consumers are included with it, or that source contribution is left out of this candidate.
CC-PFIP-3 Two questions kept separateAccepted-source incorporation and predecessor preservation receive independent conclusions.
CC-PFIP-4 Publication relations distinguishedEdition, form, expression relation, carrier, bearing relation, audience, bounded use, and publication occurrence are identified separately when they affect the comparison.
CC-PFIP-5 Pair eligibility establishedEvery one-to-one pair has the same declared use plus retained form identity or an accepted one-to-one continuity decision.
CC-PFIP-6 Complete inventory selectedEach pair uses a complete inventory selected through the FPF pattern that defines or constrains the form, or through another accepted comparison basis.
CC-PFIP-7 Non-text structure handledA non-span form uses content or selected-structure correspondence chosen for the declared use; visual or carrier similarity remains only supporting evidence.
CC-PFIP-8 Predecessor inventory coveredEvery named predecessor content or selected structure is matched, intentionally changed or retired by an accepted content decision, accidentally lost, or blocked.
CC-PFIP-9 Candidate additions classifiedCandidate content or selected structure without predecessor correspondence is classified as an accepted or unexpected addition.
CC-PFIP-10 Split and merge allocation completeEvery split or merge traverses every named predecessor inventory across named candidate expression parts even when a narrower pair survives.
CC-PFIP-11 Form and content decisions separateEvery form retirement, split, or merge has separate outcomes for the content expressed by the predecessor form.
CC-PFIP-12 Shared consumers checked onceShared public entries and direct consumers are checked once without merging the expression comparisons that depend on them.
CC-PFIP-13 Affordable resultUnchanged predecessor content and selected structure remain in the checkable traversal and do not become a positive prose ledger.
CC-PFIP-14 Authority boundary preservedThe conclusion is identified as comparison evidence; any construction, acceptance, admission, release, landing, or assurance decision is obtained separately.

Common Anti-Patterns and How to Avoid Them

Anti-patternWhat failsRepair
Source parity proves preservationAccepted additions are present, but unrelated predecessor content may be gone.Run the predecessor-to-candidate comparison independently.
Green build proves preservationSyntax and assembly succeed while meaning or selected structure disappears.Select the form-appropriate inventory and inspect semantic outcomes.
Same use means same formTwo different forms serving orientation are paired as versions.Require retained form identity or an accepted one-to-one continuity decision.
Text diff for every formDiagram relations, card fields, or retrieval cues have no meaningful shared spans.Use the FPF pattern that defines or constrains the form, C.33, or C.34 to select content or structure.
Retired form, retired contentA split or merge decision silently authorizes every old omission.Run the allocation comparison over the complete predecessor inventory.
Collective-publication shortcutSeveral forms or carriers are renamed as one bundle so one comparison seems sufficient.Keep named expressions separate and use them as inputs to the allocation comparison.
Carrier continuity as content continuityAn unchanged file or address is treated as proof that the selected edition and expression still obtain.Apply E.24.PUB and compare the selected expression, not the storage proxy.
Positive preservation ledgerEvery unchanged sentence or field receives a report row.Keep completeness checkable and report losses, accepted differences, unexpected additions, blockers, and unresolved correspondences or content-change questions.
Fabricated predecessorA first publication is forced through a predecessor comparison.Use accepted-source incorporation, complete candidate inventory, and package evaluation only.

Consequences

Framework integration becomes more reliable because a maintainer can distinguish a missing accepted change from an accidental loss of predecessor content and can compare text, diagrams, cards, and split forms without pretending they share one representation.

The cost is additional work whenever the claimed continuity affects use. Each eligible pair needs a complete form-appropriate inventory, and each split or merge needs a complete allocation traversal. The cost stays bounded because retained content needs no positive prose rows and the method is used only for accepted-source integration or publication continuity.

A later claim may rely on the conclusion only as allowed by the FPF pattern that defines or constrains that claim. The conclusion carries no process authority.

Rationale

This method belongs in the E.4 ecosystem because FPF, DPF, and LPF publications share one recurring integration problem. Accepted source carry-through and predecessor preservation answer different questions; when both are claimed, neither implies the other.

E.24.PUB distinguishes edition, expression, form, carrier, audience, use, and publication occurrence. E.17 supplies the method for reader-facing plurality. C.33 and C.34 define captured, lost, and corresponding selected structure. Repeating those contributions here would create a second publication ontology. The integration method uses these existing distinctions together.

The one-to-one and allocation branches remain separate because they answer different correspondence questions. A pair compares two expressions. An allocation traverses several named expressions without inventing a collective expression or treating a form decision as a content decision.

SoTA-Echoing

Current source branch and referenceWorking lessonAdoption in this patternBoundary
Semantic merge: Da Silva, Borba, Maciel et al. (2024), “Detecting semantic conflicts with unit tests”Current empirical semantic-merge work shows that textual and structured merge can succeed while an unwanted semantic change remains; the reported method uses behavior-relevant tests as partial specifications.Adapt. The Solution does not treat build or text-diff success as preservation evidence and requires a use-relevant inventory with explicit loss outcomes.Software tests are not imported as a universal framework-publication check; each publication form supplies its own comparison basis.
Transformation traceability and versioned co-evolution: Höppner and Tichy (2024), “Traceability and reuse mechanisms, the most important properties of model transformation languages”, and Homolka, Marchezan, Assunção et al. (2026), “What really happened to my models?”The empirical survey identifies traceability and reuse as leading transformation-language capabilities while showing that their effects vary with use and scale. The later evaluated approach retains complete model and metamodel histories, links model changes to the changes that caused them, and permits several versions to coexist.Adapt. Source contributions, predecessor content, and selected structures keep explicit candidate correspondences; source incorporation does not replace predecessor preservation; and pair results may be reused inside a larger allocation without replacing it.The survey measures transformation-language practice, and the later approach evaluates model co-evolution. Neither establishes complete traceability for a framework publication. This pattern adds no transformation language, operation history, automatic correspondence claim, or generic traceability relation.
Reusable model migration: Bettini, Di Salle, Iovino, and Pierantonio (2024), “Supporting reusable model migration with Edelta”Changes to a metamodel can invalidate dependent artifacts. The evaluated approach reuses migration patterns across domains while retaining custom or interactive rules for changes that automatic migration cannot settle.Adapt. One reusable comparison method covers FPF, DPF, and LPF; the pattern that defines or constrains a publication form supplies its form-specific inventory, and a changed public interface brings its direct consumers into the candidate.The Edelta language, metamodel kinds, automatic copier, and model-migration operations are not imported into FPF publication ontology.
Digital-preservation planning: the current NARA Digital Preservation Framework, its structured-data preservation guidance, and Becker (2018), “Metaphors We Work By”NARA selects significant properties by record type and uses them as transformation-test criteria while stating that its plans are not exhaustive or universal. Becker shows why bits, records, computed performances, and preservation claims cannot be collapsed into one digital-object metaphor.Adapt. The applicable FPF pattern defines or constrains the inventory basis, the maintainer selects the inventory for the declared use, and edition, content, form, carrier, and publication occurrence remain separate.NARA record categories and archival authenticity terms are not imported as FPF kinds or as one universal significant-property list.

These traditions support one shared stance: compare the properties and correspondences that matter for the declared use, not the easiest visible proxy. The semantic-merge row disciplines the one-to-one text case; the traceability and migration rows discipline the split-form case and direct-consumer closure; and the preservation row disciplines the diagram case and the separation of edition, form, content, and carrier. The method adapts that stance to principle-framework publications and keeps its scope narrower than general software merge, data migration, or digital preservation.

Reopen this source use when current publication-preservation or structured-transformation practice supplies a cheaper complete semantic comparison, shows that trace reuse can replace rather than only support allocation traversal, or demonstrates a non-framework use that warrants a broader pattern scope.

Relations

  • Builds on: C.2.1 for framework-episteme identity and EpistemeEditionRelation, and E.24.PUB for PublicationFormExpressionRelation, PublicationFormBearingRelation, and EpistemePublicationRelation. Together they keep the selected edition, publication form, carrier, audience, bounded use, and publication occurrence distinct.
  • Coordinates with: E.17 for several reader-facing forms and visible omissions; E.11 for public entry and discovery; C.33 for captured and lost selected structure; and C.34 for declared structural correspondence.
  • Coordinates with: E.8 for material-revision authoring and direct-consumer repair. A maintainer uses E.4.PFIP to compare an assembled principle-framework publication, not to replace pattern authoring.
  • Entry from FPF and DPF authoring: E.4.FPF refers maintainers here for integration or continuity of an FPF publication edition; E.4.DPF does the same for a DPF or LPF publication edition. Those two patterns continue to supply their respective authoring and publication-form guidance.
  • Evaluation use: A bounded preservation conclusion may be used as evidence under E.4.DPF.DA only when package adequacy for the declared use depends on publication integration or continuity. Use E.2.DA to evaluate whole-FPF adequacy and E.21 to evaluate individual pattern quality.
  • Later reliance: Use C.2.1 to identify the preservation conclusion as an episteme, A.10 when another claim relies on it, and G.11 when currentness needs qualification. Those later claims are not part of the comparison itself.

E.4.PFIP:End


Last Updated: 2026-08-23 — this section last modified in upstream FPF commit 5801dc61 (github.com/ailev/FPF)