Skip to content
Merged
Show file tree
Hide file tree
Changes from 1 commit
Commits
Show all changes
22 commits
Select commit Hold shift + click to select a range
e393793
feat(scope): add durable organization and bindings
PsiACE Sep 2, 2026
a1d0fb0
feat(migration): register existing runtime scopes
PsiACE Sep 2, 2026
99e4088
feat(artifact): publish exact revisions across scopes
PsiACE Sep 2, 2026
bbd4c4a
refactor(scope): replace project reporting with selections
PsiACE Sep 2, 2026
5cce29b
feat(integrations): resolve server-owned scopes
PsiACE Sep 2, 2026
14278d2
test(scope): verify selection and plugin contracts
PsiACE Sep 2, 2026
5d5b550
docs(scope): explain server-owned organization
PsiACE Sep 2, 2026
605701b
refactor(scope): remove legacy runtime migration
PsiACE Sep 2, 2026
d8a637d
fix(scope): retry bindings without savepoints
PsiACE Sep 2, 2026
325f20d
fix(scope): reject unregistered runtime partitions
PsiACE Sep 2, 2026
f45cc69
fix(scope): serialize hierarchy mutations
PsiACE Sep 2, 2026
056dd9e
fix(codex): guard operations by scope mode
PsiACE Sep 2, 2026
5e35afd
fix(publication): reject incomplete memory copies
PsiACE Sep 2, 2026
83f5235
chore: merge master into scope runtime
PsiACE Sep 2, 2026
3daf855
fix(ci): escape plugin shell variable safely
PsiACE Sep 2, 2026
74abed5
chore: merge latest master into scope runtime
PsiACE Sep 3, 2026
015dc00
chore: merge latest master into scope runtime
PsiACE Sep 3, 2026
befc32f
chore: merge latest master into scope runtime
PsiACE Sep 3, 2026
3a14f3a
fix(runtime): preserve referenced scope recall
PsiACE Sep 3, 2026
a7e5e7b
fix(publication): make delivery atomic
PsiACE Sep 3, 2026
94b388a
docs: use registered scope identifiers
PsiACE Sep 3, 2026
e02e10d
chore: merge latest master into scope runtime
PsiACE Sep 3, 2026
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
Prev Previous commit
Next Next commit
feat(artifact): publish exact revisions across scopes
  • Loading branch information
PsiACE committed Sep 2, 2026
commit 99e4088ac13637913da05273c4718605e4255bcb
2 changes: 2 additions & 0 deletions src/powercontext/__init__.py
Original file line number Diff line number Diff line change
Expand Up @@ -16,6 +16,7 @@

from powercontext.artifacts import (
Artifact,
ArtifactAddress,
ArtifactCatalog,
ArtifactDraft,
ArtifactLineage,
Expand Down Expand Up @@ -52,6 +53,7 @@

__all__ = [
"Artifact",
"ArtifactAddress",
"ArtifactCatalog",
"ArtifactDraft",
"ArtifactError",
Expand Down
3 changes: 2 additions & 1 deletion src/powercontext/artifacts/__init__.py
Original file line number Diff line number Diff line change
Expand Up @@ -14,11 +14,12 @@

"""Immutable artifacts and their read-only catalog contract."""

from powercontext.artifacts.models import Artifact, ArtifactDraft, ArtifactLineage, ArtifactRef
from powercontext.artifacts.models import Artifact, ArtifactAddress, ArtifactDraft, ArtifactLineage, ArtifactRef
from powercontext.artifacts.protocols import ArtifactCatalog, ArtifactStore

__all__ = [
"Artifact",
"ArtifactAddress",
"ArtifactCatalog",
"ArtifactDraft",
"ArtifactLineage",
Expand Down
28 changes: 27 additions & 1 deletion src/powercontext/artifacts/models.py
Original file line number Diff line number Diff line change
Expand Up @@ -21,7 +21,7 @@
from pydantic import BaseModel, Field, StrictInt, field_validator, model_validator

from powercontext.errors import InvalidArtifactReferenceError
from powercontext.limits import MAX_ARTIFACT_FAMILY_LENGTH, MAX_ARTIFACT_ID_LENGTH
from powercontext.limits import MAX_ARTIFACT_FAMILY_LENGTH, MAX_ARTIFACT_ID_LENGTH, MAX_SCOPE_ID_LENGTH
from powercontext.sources.models import SourceRef

ContentT = TypeVar("ContentT", covariant=True)
Expand All @@ -44,11 +44,37 @@ def validate_identity(cls, value: str, info) -> str:
return value


class ArtifactAddress(BaseModel):
"""A complete address for one exact Artifact revision across Scope boundaries."""

scope_id: str
artifact: ArtifactRef

@field_validator("scope_id")
@classmethod
def validate_scope_id(cls, value: str) -> str:
_validate_reference_part("scope_id", value)
if len(value) > MAX_SCOPE_ID_LENGTH:
raise InvalidArtifactReferenceError(
"scope_id",
f"must not exceed {MAX_SCOPE_ID_LENGTH} characters",
)
return value


class ArtifactLineage(BaseModel):
"""The direct evidence used to produce one artifact revision."""

sources: tuple[SourceRef, ...] = ()
artifacts: tuple[ArtifactRef, ...] = ()
publication_source: ArtifactAddress | None = None
publication_digest: str | None = None

@model_validator(mode="after")
def require_complete_publication_provenance(self):
if (self.publication_source is None) != (self.publication_digest is None):
raise ValueError("publication source and digest must be provided together") # noqa: TRY003
return self


class ArtifactDraft(BaseModel, Generic[ContentT]):
Expand Down
97 changes: 97 additions & 0 deletions src/powercontext/builtin/persistence/artifacts.py
Original file line number Diff line number Diff line change
Expand Up @@ -26,20 +26,23 @@

from powercontext.artifacts import (
Artifact,
ArtifactAddress,
ArtifactDraft,
ArtifactLineage,
ArtifactRef,
)
from powercontext.builtin.persistence.codec import dump_model, load_model, stored_bytes
from powercontext.builtin.persistence.errors import (
IdentityMismatchError,
InvalidPublicationLineageError,
InvalidRepositoryArgumentError,
RepositoryNotFoundError,
)
from powercontext.builtin.persistence.tables import (
ARTIFACT_HEADS_TABLE,
ARTIFACT_LINEAGE_ARTIFACTS_TABLE,
ARTIFACT_LINEAGE_SOURCES_TABLE,
ARTIFACT_PUBLICATIONS_TABLE,
ARTIFACTS_TABLE,
)
from powercontext.errors import (
Expand Down Expand Up @@ -240,6 +243,42 @@ async def revisions(
revisions.append(await self._decode_row(connection, row))
return tuple(revisions)

async def copy_exact(
self,
connection: AsyncConnection,
target_scope_id: str,
target_artifact_id: str,
source_address: ArtifactAddress,
source: Artifact[Any],
content_digest: str,
/,
) -> Artifact[Any]:
"""Create an independent target lifecycle from one exact source revision."""

_require_scope(target_scope_id)
artifact_type = self._artifact_type(source.family)
ref = ArtifactRef(family=source.family, artifact_id=target_artifact_id, revision=1)
copied = await self._insert_revision(
connection,
target_scope_id,
artifact_type,
ref,
source.content,
Comment thread
PsiACE marked this conversation as resolved.
Resolved
ArtifactLineage(
publication_source=source.lineage.publication_source or source_address,
publication_digest=source.lineage.publication_digest or content_digest,
),
)
await connection.execute(
insert(ARTIFACT_HEADS_TABLE).values(
scope_id=target_scope_id,
family=ref.family,
artifact_id=ref.artifact_id,
revision=ref.revision,
)
)
return copied

async def _insert_revision(
self,
connection: AsyncConnection,
Expand Down Expand Up @@ -370,6 +409,10 @@ async def _load_lineage(
.order_by(ARTIFACT_LINEAGE_ARTIFACTS_TABLE.c.ordinal)
)
).all()
publication_source, publication_digest = await self._load_publication_provenance(
connection,
ArtifactAddress(scope_id=scope_id, artifact=ref),
)
return ArtifactLineage(
sources=tuple(SourceRef(source_type=str(row.source_type), source_id=str(row.source_id)) for row in sources),
artifacts=tuple(
Expand All @@ -380,8 +423,62 @@ async def _load_lineage(
)
for row in artifacts
),
publication_source=publication_source,
publication_digest=publication_digest,
)

async def _load_publication_provenance(
self,
connection: AsyncConnection,
target: ArtifactAddress,
) -> tuple[ArtifactAddress | None, str | None]:
"""Resolve a publication chain to the Scope that owns the original revision."""

current = target
digest: str | None = None
visited: set[tuple[str, str, str, int]] = set()
while True:
key = (
current.scope_id,
current.artifact.family,
current.artifact.artifact_id,
current.artifact.revision,
)
if key in visited:
raise InvalidPublicationLineageError("cycle")
visited.add(key)

publication = (
(
await connection.execute(
select(ARTIFACT_PUBLICATIONS_TABLE).where(
ARTIFACT_PUBLICATIONS_TABLE.c.target_scope_id == current.scope_id,
ARTIFACT_PUBLICATIONS_TABLE.c.target_family == current.artifact.family,
ARTIFACT_PUBLICATIONS_TABLE.c.target_artifact_id == current.artifact.artifact_id,
ARTIFACT_PUBLICATIONS_TABLE.c.target_revision == current.artifact.revision,
)
)
)
.mappings()
.one_or_none()
)
if publication is None:
return (None, None) if digest is None else (current, digest)

current_digest = str(publication["content_digest"])
if digest is None:
digest = current_digest
elif digest != current_digest:
raise InvalidPublicationLineageError("digest")
current = ArtifactAddress(
scope_id=str(publication["source_scope_id"]),
artifact=ArtifactRef(
family=str(publication["source_family"]),
artifact_id=str(publication["source_artifact_id"]),
revision=int(publication["source_revision"]),
),
)

async def _head_conflict(
self,
connection: AsyncConnection,
Expand Down
9 changes: 9 additions & 0 deletions src/powercontext/builtin/persistence/errors.py
Original file line number Diff line number Diff line change
Expand Up @@ -88,6 +88,15 @@ def __init__(self, column: str, expected: str) -> None:
super().__init__(f"stored {column} column is not {expected}")


class InvalidPublicationLineageError(RepositoryError):
"""Raised when persisted publication provenance cannot form one exact chain."""

def __init__(self, issue: str) -> None:
self.issue = issue
detail = "inconsistent content digests" if issue == "digest" else issue
super().__init__(f"invalid publication lineage: {detail}")


class GenerationConflictError(RepositoryError):
"""Raised when Trigger State compare-and-swap observes another generation."""

Expand Down
38 changes: 38 additions & 0 deletions src/powercontext/builtin/persistence/tables.py
Original file line number Diff line number Diff line change
Expand Up @@ -270,6 +270,43 @@ def _entry_text_type():
),
)

ARTIFACT_PUBLICATIONS_TABLE = Table(
"pc_artifact_publications",
SHARED_METADATA,
Column("target_scope_id", identity_string(MAX_SCOPE_ID_LENGTH), primary_key=True),
Column("target_family", identity_string(MAX_ARTIFACT_FAMILY_LENGTH), primary_key=True),
Column("target_artifact_id", identity_string(MAX_ARTIFACT_ID_LENGTH), primary_key=True),
Column("target_revision", Integer, primary_key=True),
Column("source_scope_id", identity_string(MAX_SCOPE_ID_LENGTH), nullable=False),
Column("source_family", identity_string(MAX_ARTIFACT_FAMILY_LENGTH), nullable=False),
Column("source_artifact_id", identity_string(MAX_ARTIFACT_ID_LENGTH), nullable=False),
Column("source_revision", Integer, nullable=False),
Column("content_digest", identity_string(64), nullable=False),
Column("idempotency_key", identity_string(MAX_SCOPE_IDEMPOTENCY_KEY_LENGTH), nullable=False),
ForeignKeyConstraint(
("target_scope_id", "target_family", "target_artifact_id", "target_revision"),
(
"pc_artifacts.scope_id",
"pc_artifacts.family",
"pc_artifacts.artifact_id",
"pc_artifacts.revision",
),
ondelete="RESTRICT",
),
ForeignKeyConstraint(
("source_scope_id", "source_family", "source_artifact_id", "source_revision"),
(
"pc_artifacts.scope_id",
"pc_artifacts.family",
"pc_artifacts.artifact_id",
"pc_artifacts.revision",
),
ondelete="RESTRICT",
),
UniqueConstraint("target_scope_id", "idempotency_key", name="uq_pc_artifact_publications_request"),
)


ARTIFACT_CANDIDATE_VERSIONS_TABLE = Table(
"pc_artifact_candidate_versions",
SHARED_METADATA,
Expand Down Expand Up @@ -438,6 +475,7 @@ def _entry_text_type():
ARTIFACT_HEADS_TABLE,
ARTIFACT_LINEAGE_SOURCES_TABLE,
ARTIFACT_LINEAGE_ARTIFACTS_TABLE,
ARTIFACT_PUBLICATIONS_TABLE,
ARTIFACT_CANDIDATE_VERSIONS_TABLE,
ARTIFACT_CANDIDATE_HEADS_TABLE,
SOURCE_CURSORS_TABLE,
Expand Down
Loading