@receiz/ai-skills 106.0.0 → 108.0.0
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/README.md +15 -6
- package/package.json +13 -2
- package/receiz-app-builder-skill/SKILL.md +85 -2
- package/receiz-app-builder-skill/examples/proof-verifier.md +4 -3
- package/receiz-app-builder-skill/manifest.json +17 -0
- package/receiz-architecture/manifest.json +6 -6
- package/receiz-authority-security/manifest.json +6 -6
- package/receiz-bearer-ownership/SKILL.md +69 -0
- package/receiz-bearer-ownership/agents/openai.yaml +4 -0
- package/receiz-bearer-ownership/manifest.json +14 -0
- package/receiz-build-production-system/manifest.json +6 -6
- package/receiz-causal-sync/manifest.json +6 -6
- package/receiz-command-builder/manifest.json +6 -6
- package/receiz-commerce-skill/SKILL.md +1 -1
- package/receiz-constitutional-laws/manifest.json +6 -6
- package/receiz-cross-app-state/SKILL.md +151 -0
- package/receiz-cross-app-state/agents/openai.yaml +4 -0
- package/receiz-cross-app-state/manifest.json +18 -0
- package/receiz-deterministic-replay/manifest.json +6 -6
- package/receiz-domain-builder/manifest.json +6 -6
- package/receiz-identity-profile/SKILL.md +67 -0
- package/receiz-identity-profile/agents/openai.yaml +4 -0
- package/receiz-identity-profile/manifest.json +14 -0
- package/receiz-mcp-agent-skill/resources/mcp-tool-map.md +32 -2
- package/receiz-migrations/SKILL.md +86 -4
- package/receiz-migrations/agents/openai.yaml +1 -1
- package/receiz-migrations/manifest.json +14 -54
- package/receiz-observability/manifest.json +6 -6
- package/receiz-offline-command/SKILL.md +70 -0
- package/receiz-offline-command/agents/openai.yaml +4 -0
- package/receiz-offline-command/manifest.json +14 -0
- package/receiz-offline-first/manifest.json +6 -6
- package/receiz-offline-verifier-skill/SKILL.md +85 -2
- package/receiz-offline-verifier-skill/examples/verify-offline-asset.md +2 -2
- package/receiz-offline-verifier-skill/manifest.json +17 -0
- package/receiz-offline-verifier-skill/resources/artifact-over-server.md +2 -2
- package/receiz-performance/manifest.json +6 -6
- package/receiz-portable-artifacts/SKILL.md +85 -3
- package/receiz-portable-artifacts/agents/openai.yaml +1 -1
- package/receiz-portable-artifacts/manifest.json +17 -52
- package/receiz-portable-continuity/SKILL.md +70 -0
- package/receiz-portable-continuity/agents/openai.yaml +4 -0
- package/receiz-portable-continuity/manifest.json +14 -0
- package/receiz-proof-media/SKILL.md +68 -0
- package/receiz-proof-media/agents/openai.yaml +4 -0
- package/receiz-proof-media/manifest.json +14 -0
- package/receiz-proof-skill/SKILL.md +86 -3
- package/receiz-proof-skill/examples/verify-card.md +1 -1
- package/receiz-proof-skill/examples/verify-post.md +1 -1
- package/receiz-proof-skill/manifest.json +17 -0
- package/receiz-proof-skill/resources/sdk-reference.md +36 -3
- package/receiz-proof-skill/resources/verification-flow.md +4 -4
- package/receiz-receipt-admission/SKILL.md +61 -0
- package/receiz-receipt-admission/agents/openai.yaml +4 -0
- package/receiz-receipt-admission/manifest.json +14 -0
- package/receiz-release/SKILL.md +85 -3
- package/receiz-release/agents/openai.yaml +1 -1
- package/receiz-release/manifest.json +14 -54
- package/receiz-testing/SKILL.md +85 -3
- package/receiz-testing/agents/openai.yaml +1 -1
- package/receiz-testing/manifest.json +14 -55
- package/scripts/validate-skills.ts +485 -0
package/README.md
CHANGED
|
@@ -1,28 +1,37 @@
|
|
|
1
1
|
# Receiz AI Skills
|
|
2
2
|
|
|
3
|
-
`receiz-build-production-system`
|
|
3
|
+
`receiz-build-production-system` remains the constitutional orchestration skill for substantial
|
|
4
4
|
Receiz applications. Fourteen focused constitutional skills supply architecture,
|
|
5
5
|
domain, law, command, authority, replay, offline, causal, artifact, migration,
|
|
6
6
|
performance, observability, testing, and release contracts. The earlier nine
|
|
7
|
-
domain
|
|
7
|
+
domain skill names remain packaged for compatibility. Seven operation skill names first introduced in v107 now
|
|
8
|
+
describe current v108 outcomes for identity profiles, portable continuity, bearer ownership, offline transport,
|
|
9
|
+
proof media, cross-app state, and admission evidence. Their retired v107 mechanisms are not active defaults.
|
|
10
|
+
Every current manifest uses schema and version `v108` / `108.0.0`, requires SDK/MCP `>=108.0.0 <109.0.0`, and binds ruleset `108.0.0` to registry digest `126ca9283fee4ef4c398dbcb958e861cbea191724fdab8eb08df55ff0c14bb79`.
|
|
8
11
|
|
|
9
12
|
This package teaches AI agents how to understand, verify, build with, and operate Receiz from the existing repository surfaces.
|
|
10
13
|
|
|
11
|
-
It is published as `@receiz/ai-skills` and is an exact-version dependency of both `@receiz/sdk` and `@receiz/mcp-server`. Installing either package places all
|
|
14
|
+
It is published as `@receiz/ai-skills` and is an exact-version dependency of both `@receiz/sdk` and `@receiz/mcp-server`. Installing either package places all thirty-one skill directories under `node_modules/@receiz/ai-skills` for explicit loading by an agent host.
|
|
12
15
|
|
|
13
|
-
Receiz is a proof-native artifact system.
|
|
16
|
+
Receiz is a proof-native artifact system. Sealed proof/object truth is strongest: a Receiz object is not a database row, but a proof-carrying artifact whose witnessed history is the truth boundary. The proof object carries continuity; SDK and MCP may verify, extract, append, or project beneath that carried truth. Receiz.com reference behavior comes before SDK, MCP, AI, and other developer rails. Server state, database state, UI state, marketplace state, and model memory are projections only. Old witnessed truth is not stale. If a projection is wrong, rebuild it from object history. If truth is missing, append new truth. Never mutate witnessed truth.
|
|
17
|
+
|
|
18
|
+
A verified proof object is not limited to the platform that created it. Any lawful platform may append authenticated ownership and history only while preserving the same immutable object identity, payload, provenance root, prior history, and unknown namespaces, then returning a complete verified proof object. AI skills adapt to that continuity and never invent an origin-platform authority or parallel chain.
|
|
14
19
|
|
|
15
20
|
## SDK, MCP, And Skills
|
|
16
21
|
|
|
17
22
|
- SDK: `@receiz/sdk` is the universal runtime; `@receiz/sdk/react` is React-only; `@receiz/sdk/compiler` is Node-only; `@receiz/sdk/testing` is browser-safe sandbox and conformance support.
|
|
18
|
-
- MCP: `@receiz/mcp-server` is for agent tool access.
|
|
23
|
+
- MCP: `@receiz/mcp-server` is for agent tool access. Its six artifact custody tools plan/execute native Record -> Seal, verify the complete artifact, extract only after verification, check exact byte round trip, and explain evidence through the same SDK artifact verifier. Diagnostics, public reads, app-state/public-store actions, previews, and delegated writes remain beneath proof truth.
|
|
19
24
|
- Skills: this package is operating doctrine. It tells an AI which Receiz primitive is active, which source of truth wins, which SDK or MCP rail to use, and what must never be assumed.
|
|
20
25
|
|
|
21
26
|
Agents may acquire scoped delegated access through the official Receiz Connect/OIDC Authorization Code + PKCE flow or through the MCP delegated-agent setup path exposed by `receiz_mcp_login`. That acquired access is permission to call scoped SDK/MCP rails after user consent. It is not proof authority and must never outrank artifact truth.
|
|
22
27
|
|
|
23
28
|
## How Agents Should Use This Package
|
|
24
29
|
|
|
25
|
-
Start with `receiz-build-production-system` when work spans multiple constitutional domains. Its machine-readable manifest requires the exact active signed registry digest, command-only mutation, independent verification, MCP conformance, and a passing release lock. Use a focused
|
|
30
|
+
Start with `receiz-build-production-system` when work spans multiple constitutional domains. Its machine-readable manifest requires the exact active signed registry digest, command-only mutation, independent verification, MCP conformance, and a passing release lock. Use a focused operation skill for SDK/MCP implementation and a constitutional skill for broader system law. Stable v107 wire schemas remain available only through the explicit historical `@receiz/sdk/v107` package entry; current skills never teach their key, head, receipt, reconcile, or signed-command mechanics as a v108 outcome.
|
|
31
|
+
|
|
32
|
+
The v108 operation skills are executable contracts. Current profile work uses the neutral authenticated same-UID profile operation. Current bearer ownership accepts a complete verified artifact, derives prior ownership from carried proof, and returns a native Record -> Seal artifact. Proof media uses the same native artifact custody and projects only a verified URL beneath it. These outcomes have no active identity-key, caller-head, claim-key, or receipt prerequisite. MCP calls the same SDK outcomes and never creates a parallel authority.
|
|
33
|
+
|
|
34
|
+
Stable v107 schema names and their head/receipt mechanics remain explicitly historical compatibility, not the active/default profile, bearer, or proof-media contract.
|
|
26
35
|
|
|
27
36
|
Do not invent APIs. Use the SDK and MCP maps inside the skills, then inspect the repo when a requested operation is not listed.
|
|
28
37
|
|
package/package.json
CHANGED
|
@@ -1,10 +1,11 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "@receiz/ai-skills",
|
|
3
|
-
"version": "
|
|
3
|
+
"version": "108.0.0",
|
|
4
4
|
"description": "Authoritative Receiz AI operating skills for proof-native SDK and MCP agents.",
|
|
5
5
|
"type": "module",
|
|
6
6
|
"files": [
|
|
7
7
|
"README.md",
|
|
8
|
+
"scripts",
|
|
8
9
|
"receiz-app-builder-skill",
|
|
9
10
|
"receiz-builder-skill",
|
|
10
11
|
"receiz-commerce-skill",
|
|
@@ -28,7 +29,14 @@
|
|
|
28
29
|
"receiz-observability",
|
|
29
30
|
"receiz-testing",
|
|
30
31
|
"receiz-release",
|
|
31
|
-
"receiz-build-production-system"
|
|
32
|
+
"receiz-build-production-system",
|
|
33
|
+
"receiz-identity-profile",
|
|
34
|
+
"receiz-portable-continuity",
|
|
35
|
+
"receiz-bearer-ownership",
|
|
36
|
+
"receiz-offline-command",
|
|
37
|
+
"receiz-proof-media",
|
|
38
|
+
"receiz-cross-app-state",
|
|
39
|
+
"receiz-receipt-admission"
|
|
32
40
|
],
|
|
33
41
|
"keywords": [
|
|
34
42
|
"receiz",
|
|
@@ -43,5 +51,8 @@
|
|
|
43
51
|
"license": "MIT",
|
|
44
52
|
"publishConfig": {
|
|
45
53
|
"access": "public"
|
|
54
|
+
},
|
|
55
|
+
"scripts": {
|
|
56
|
+
"test": "node --import tsx scripts/validate-skills.ts"
|
|
46
57
|
}
|
|
47
58
|
}
|
|
@@ -8,6 +8,89 @@ description: Use when starting, integrating, upgrading, diagnosing, or repairing
|
|
|
8
8
|
Build and upgrade Receiz applications from one typed contract. The compiler is
|
|
9
9
|
integration tooling beneath Receiz proof truth; inspection is not verification.
|
|
10
10
|
|
|
11
|
+
## Binding v108 artifact law
|
|
12
|
+
|
|
13
|
+
A Receiz artifact is the exact byte sequence returned by native Record -> Seal. The inner payload is never an acceptable substitute.
|
|
14
|
+
|
|
15
|
+
A verified proof object is not limited to the platform that created it. Any lawful platform may append authenticated ownership and history only while preserving the same immutable object identity, payload, provenance root, prior history, and unknown namespaces, then returning a complete verified proof object.
|
|
16
|
+
|
|
17
|
+
Label every byte sequence generated or consumed by the application:
|
|
18
|
+
|
|
19
|
+
- `payload`: application bytes exposed separately only after the enclosing artifact verifies.
|
|
20
|
+
- `sealed artifact`: the indivisible SDK-issued Record -> Seal bytes carrying integrity, Signature V4, owner, claim, verify path, provenance, and payload binding.
|
|
21
|
+
|
|
22
|
+
## Required SDK artifact workflow
|
|
23
|
+
|
|
24
|
+
```ts
|
|
25
|
+
const payload = { bytes: applicationPayload, mimeType: applicationMimeType };
|
|
26
|
+
const sealedArtifact = await receiz.assets.createProofObject(
|
|
27
|
+
{ assetType: "proof_object", payload },
|
|
28
|
+
{ filename: applicationFilename, idempotencyKey },
|
|
29
|
+
);
|
|
30
|
+
const downloadEvidence = await receiz.artifacts.download(sealedArtifact);
|
|
31
|
+
const opened = await receiz.artifacts.verifyAndOpen(savedArtifactFile);
|
|
32
|
+
if (downloadEvidence.artifactSha256 !== sealedArtifact.artifactSha256) throw new Error("artifact_digest_mismatch");
|
|
33
|
+
if (opened.sealedArtifact.artifactSha256 !== sealedArtifact.artifactSha256) throw new Error("saved_artifact_mismatch");
|
|
34
|
+
if (opened.verifiedPayload.sha256 !== sealedArtifact.payloadSha256) throw new Error("payload_binding_mismatch");
|
|
35
|
+
```
|
|
36
|
+
|
|
37
|
+
Independently hash the saved bytes and require equality with `sealedArtifact.artifactSha256`. Require `verification.ok`, `integrity.ok`, carrier `native-record-seal`, Signature V4, owner, claim, and verify-path agreement. Reopen the exact saved file with `verifyAndOpen`, then prove a different Receiz application preserves identity, cards, history, receipts, and unknown namespaces. Current exports use native Record -> Seal; verified legacy artifacts remain read-compatible only.
|
|
38
|
+
|
|
39
|
+
## Twelve-step artifact workflow
|
|
40
|
+
|
|
41
|
+
1. Label the input bytes as `payload`; never call them an artifact.
|
|
42
|
+
2. Load the active signed v108 registry and `ARTIFACT-001` through `ARTIFACT-010`.
|
|
43
|
+
3. Call `receiz.assets.createProofObject` so Receiz.com performs native Record -> Seal.
|
|
44
|
+
4. Require an SDK-issued `receiz.native-record-seal`; failure returns no artifact and no payload fallback.
|
|
45
|
+
5. Require complete enclosing-artifact verification, integrity, Signature V4, owner, claim, verify path, and payload binding.
|
|
46
|
+
6. Call `receiz.artifacts.download` with only that SDK-issued sealed artifact.
|
|
47
|
+
7. Independently hash the exact saved artifact bytes without repacking or relabeling them.
|
|
48
|
+
8. Require the saved artifact digest to equal the SDK-issued artifact digest.
|
|
49
|
+
9. Reopen the exact saved file through `receiz.artifacts.verifyAndOpen` before payload extraction.
|
|
50
|
+
10. Pass only `opened.verifiedPayload.bytes` to domain parsers and preserve unknown namespaces.
|
|
51
|
+
11. Exercise a different Receiz application projection and prove identity, ownership history, namespaces, and byte round trip remain intact.
|
|
52
|
+
12. Record every production-ready evidence field below and refuse completion if any field is absent or failing.
|
|
53
|
+
|
|
54
|
+
When MCP is available, use only these current artifact tools; each remains subordinate to the SDK and enclosing proof:
|
|
55
|
+
|
|
56
|
+
- `receiz_artifact_record_seal_plan`
|
|
57
|
+
- `receiz_artifact_record_seal_execute`
|
|
58
|
+
- `receiz_artifact_verify`
|
|
59
|
+
- `receiz_artifact_extract_verified`
|
|
60
|
+
- `receiz_artifact_round_trip_check`
|
|
61
|
+
- `receiz_artifact_explain`
|
|
62
|
+
|
|
63
|
+
## Artifact prohibitions
|
|
64
|
+
|
|
65
|
+
- Never download an unsealed payload fallback.
|
|
66
|
+
- Never call an inner payload a Receiz artifact.
|
|
67
|
+
- Never relabel payload bytes as a Receiz artifact.
|
|
68
|
+
- Never repack, wrap, recompress, or modify native Record -> Seal bytes.
|
|
69
|
+
- Never treat shape validation as artifact verification.
|
|
70
|
+
- Never delete unknown cross-application namespaces.
|
|
71
|
+
- Never rewrite immutable ownership or provenance history.
|
|
72
|
+
- Never weaken a failing test to accept payload-only continuity.
|
|
73
|
+
- Never claim success from UI rendering alone.
|
|
74
|
+
|
|
75
|
+
## Production-ready evidence
|
|
76
|
+
|
|
77
|
+
Refuse to call the artifact production-ready when any field is absent or failing:
|
|
78
|
+
|
|
79
|
+
```md
|
|
80
|
+
SDK version:
|
|
81
|
+
Registry digest:
|
|
82
|
+
Artifact law version:
|
|
83
|
+
Artifact carrier:
|
|
84
|
+
Signature version:
|
|
85
|
+
Artifact digest:
|
|
86
|
+
Payload digest:
|
|
87
|
+
Owner and claim binding:
|
|
88
|
+
Independent verification result:
|
|
89
|
+
Cross-platform round-trip result:
|
|
90
|
+
Legacy compatibility result:
|
|
91
|
+
Release-lock result:
|
|
92
|
+
```
|
|
93
|
+
|
|
11
94
|
## When To Use This Skill
|
|
12
95
|
|
|
13
96
|
- Use for `defineReceizApp`, `receiz.app.contract.v1`, or `receiz app` commands.
|
|
@@ -71,8 +154,8 @@ Import `defineReceizApp`, `validateReceizAppContract`,
|
|
|
71
154
|
`compileReceizAppContract`, `inspectReceizProject`,
|
|
72
155
|
`planReceizIntegration`, `checkReceizIntegration`, `planReceizUpgrade`, and
|
|
73
156
|
`explainReceizIntegrationFinding` from `@receiz/sdk/compiler`. Artifact verification remains
|
|
74
|
-
`
|
|
75
|
-
Record-before-Seal rail.
|
|
157
|
+
`artifacts.verifyAndOpen`; creation and download remain `assets.createProofObject`
|
|
158
|
+
and `artifacts.download` on the SDK's authenticated native Record-before-Seal rail.
|
|
76
159
|
|
|
77
160
|
## Output Format
|
|
78
161
|
|
|
@@ -1,5 +1,6 @@
|
|
|
1
1
|
# Proof Verifier Starter Contract
|
|
2
2
|
|
|
3
|
-
Select `proof` and optionally `proofMemory`.
|
|
4
|
-
|
|
5
|
-
|
|
3
|
+
Select `proof` and optionally `proofMemory`. Label byte-bearing inputs as payload
|
|
4
|
+
or sealed artifact. Route complete sealed files to SDK `artifacts.verifyAndOpen`
|
|
5
|
+
and domain parsers only to `opened.verifiedPayload.bytes`. MCP inspection and
|
|
6
|
+
repository checks never supply the verification verdict.
|
|
@@ -0,0 +1,17 @@
|
|
|
1
|
+
{
|
|
2
|
+
"schema": "receiz.ai-skill-contract.v108",
|
|
3
|
+
"name": "receiz-app-builder-skill",
|
|
4
|
+
"version": "108.0.0",
|
|
5
|
+
"requires": { "sdk": ">=108.0.0 <109.0.0", "mcp": ">=108.0.0 <109.0.0", "ruleset": "108.0.0", "registryDigest": "126ca9283fee4ef4c398dbcb958e861cbea191724fdab8eb08df55ff0c14bb79" },
|
|
6
|
+
"artifactLawVersion": "108.0.0",
|
|
7
|
+
"artifactLaws": ["ARTIFACT-001", "ARTIFACT-002", "ARTIFACT-003", "ARTIFACT-004", "ARTIFACT-005", "ARTIFACT-006", "ARTIFACT-007", "ARTIFACT-008", "ARTIFACT-009", "ARTIFACT-010"],
|
|
8
|
+
"laws": ["receiz.artifact.sealed-truth", "receiz.compiler.beneath-proof", "receiz.artifact.verify-before-extract", "ownership.cross-platform-proof-object-continuity"],
|
|
9
|
+
"sdkOperations": ["assets.createProofObject", "artifacts.download", "artifacts.verifyAndOpen"],
|
|
10
|
+
"allowedTools": ["receiz_project_inspect", "receiz_app_plan", "receiz_app_apply", "receiz_app_check", "receiz_release_qualify"],
|
|
11
|
+
"forbiddenOperations": ["direct-state-write", "payload-fallback", "payload-relabel-as-artifact", "artifact-repack", "shape-only-verification", "history-rewrite", "authority-bypass"],
|
|
12
|
+
"requiredInputs": ["repository-root", "installed-sdk-version", "active-registry-digest", "artifact-law-version", "labeled-byte-domains", "cross-app-destination"],
|
|
13
|
+
"requiredEvidence": ["typecheck", "conformance", "exact-artifact-byte-identity", "artifact-digest-match", "payload-digest-binding", "signature-v4", "owner-claim-binding", "independent-artifact-verification", "cross-platform-round-trip", "legacy-read-compatibility", "release-lock-pass"],
|
|
14
|
+
"requiredCompletionFields": ["sdk-version", "registry-digest", "artifact-law-version", "artifact-carrier", "signature-version", "artifact-digest", "payload-digest", "owner-and-claim-binding", "independent-verification-result", "cross-platform-round-trip-result", "legacy-compatibility-result", "release-lock-result"],
|
|
15
|
+
"completionCriteria": ["all-required-evidence-pass", "release-lock-pass"],
|
|
16
|
+
"maximumAutonomousAuthority": "inspect-plan-scaffold-test"
|
|
17
|
+
}
|
|
@@ -1,11 +1,12 @@
|
|
|
1
1
|
{
|
|
2
|
-
"schema": "receiz.ai-skill-contract.
|
|
2
|
+
"schema": "receiz.ai-skill-contract.v108",
|
|
3
3
|
"name": "receiz-architecture",
|
|
4
|
+
"version": "108.0.0",
|
|
4
5
|
"requires": {
|
|
5
|
-
"sdk": ">=
|
|
6
|
-
"mcp": ">=
|
|
7
|
-
"ruleset": "
|
|
8
|
-
"registryDigest": "
|
|
6
|
+
"sdk": ">=108.0.0 <109.0.0",
|
|
7
|
+
"mcp": ">=108.0.0 <109.0.0",
|
|
8
|
+
"ruleset": "108.0.0",
|
|
9
|
+
"registryDigest": "126ca9283fee4ef4c398dbcb958e861cbea191724fdab8eb08df55ff0c14bb79"
|
|
9
10
|
},
|
|
10
11
|
"laws": [
|
|
11
12
|
"receiz.truth.stronger-first",
|
|
@@ -54,4 +55,3 @@
|
|
|
54
55
|
],
|
|
55
56
|
"maximumAutonomousAuthority": "inspect-plan-scaffold-test"
|
|
56
57
|
}
|
|
57
|
-
|
|
@@ -1,11 +1,12 @@
|
|
|
1
1
|
{
|
|
2
|
-
"schema": "receiz.ai-skill-contract.
|
|
2
|
+
"schema": "receiz.ai-skill-contract.v108",
|
|
3
3
|
"name": "receiz-authority-security",
|
|
4
|
+
"version": "108.0.0",
|
|
4
5
|
"requires": {
|
|
5
|
-
"sdk": ">=
|
|
6
|
-
"mcp": ">=
|
|
7
|
-
"ruleset": "
|
|
8
|
-
"registryDigest": "
|
|
6
|
+
"sdk": ">=108.0.0 <109.0.0",
|
|
7
|
+
"mcp": ">=108.0.0 <109.0.0",
|
|
8
|
+
"ruleset": "108.0.0",
|
|
9
|
+
"registryDigest": "126ca9283fee4ef4c398dbcb958e861cbea191724fdab8eb08df55ff0c14bb79"
|
|
9
10
|
},
|
|
10
11
|
"laws": [
|
|
11
12
|
"receiz.authority.capability-bound",
|
|
@@ -55,4 +56,3 @@
|
|
|
55
56
|
],
|
|
56
57
|
"maximumAutonomousAuthority": "inspect-plan-scaffold-test"
|
|
57
58
|
}
|
|
58
|
-
|
|
@@ -0,0 +1,69 @@
|
|
|
1
|
+
---
|
|
2
|
+
name: receiz-bearer-ownership
|
|
3
|
+
description: Use when claiming a qualifying Receiz bearer proof object from a complete verified artifact and returning its new native sealed artifact.
|
|
4
|
+
---
|
|
5
|
+
|
|
6
|
+
# Receiz Bearer Ownership
|
|
7
|
+
|
|
8
|
+
Claim the enclosing proof object, not a detached payload or a card-specific invention. Preserve the verified carried ownership chain through the new native artifact.
|
|
9
|
+
|
|
10
|
+
## Exact SDK operation
|
|
11
|
+
|
|
12
|
+
Verify and open the complete sealed artifact first. Pass only the runtime-issued sealed-artifact handle into the ownership operation, then download the exact new artifact.
|
|
13
|
+
|
|
14
|
+
```ts
|
|
15
|
+
import { createReceizClient } from "@receiz/sdk";
|
|
16
|
+
|
|
17
|
+
const receiz = createReceizClient({ accessToken });
|
|
18
|
+
const opened = await receiz.artifacts.verifyAndOpen(artifactFile);
|
|
19
|
+
const claimed = await receiz.ownership.claimBearerAsset({
|
|
20
|
+
artifact: opened.sealedArtifact,
|
|
21
|
+
});
|
|
22
|
+
const downloadEvidence = await receiz.artifacts.download(claimed);
|
|
23
|
+
```
|
|
24
|
+
|
|
25
|
+
`opened.verifiedPayload` is an inspected projection. Ownership input remains `opened.sealedArtifact`, the complete sealed artifact.
|
|
26
|
+
|
|
27
|
+
## Required authority
|
|
28
|
+
|
|
29
|
+
Treat the enclosing sealed proof object and its carried ownership continuity as stronger truth. Bind the new owner to the authenticated Receiz account. Keep the server, SDK, MCP, and AI beneath those primitives.
|
|
30
|
+
|
|
31
|
+
The proof object is not limited to the platform that created it. Any lawful platform may verify it and append authenticated ownership and history through the same operation, provided the result preserves the same immutable object identity, payload, provenance root, and prior history and returns a newly verified complete proof object.
|
|
32
|
+
|
|
33
|
+
Require the signed-in session or delegated `receiz:record` and `receiz:seal` scopes. Do not accept a caller-selected owner, identity key, claim key, or proof head.
|
|
34
|
+
|
|
35
|
+
## Required proof object
|
|
36
|
+
|
|
37
|
+
Require a complete sealed artifact that passes enclosing integrity, Signature V4, claim/path, owner, and payload-binding verification. Reject payload bytes, a self-hash, an arbitrary Blob, or a caller-constructed artifact handle.
|
|
38
|
+
|
|
39
|
+
Prior ownership is derived from the verified carried proof payload. Never fetch or accept a caller-provided latest ownership head as the authority boundary.
|
|
40
|
+
|
|
41
|
+
## Deterministic behavior
|
|
42
|
+
|
|
43
|
+
Append the authenticated Receiz owner to the verified carried ownership document, then run native Record -> Seal. Return only the newly verified complete artifact. Use `artifacts.download` to preserve its exact bytes and metadata.
|
|
44
|
+
|
|
45
|
+
## Offline behavior
|
|
46
|
+
|
|
47
|
+
Retain the original artifact and its verified local truth when network service is unavailable. Do not report an ownership claim as complete until authenticated Record -> Seal returns the new verified artifact.
|
|
48
|
+
|
|
49
|
+
## Conflict behavior
|
|
50
|
+
|
|
51
|
+
On failed enclosing verification, non-bearer custody, authenticated-owner failure, Record failure, Seal failure, or custody conflict, return no claimed artifact. Never retry by substituting a server row, caller head, or detached payload.
|
|
52
|
+
|
|
53
|
+
## Result verification
|
|
54
|
+
|
|
55
|
+
Require a runtime-issued current native artifact with complete verification, authenticated owner continuity, Record identity, claim/path binding, Signature V4, and native Record -> Seal continuity. A receipt is not emitted or required for this current outcome.
|
|
56
|
+
|
|
57
|
+
## User confirmation
|
|
58
|
+
|
|
59
|
+
Show the source artifact identity, verified current custody, authenticated destination account, and the consequence of creating a new ownership artifact. Never ask for a claimant key ID or expected ownership head.
|
|
60
|
+
|
|
61
|
+
## MCP parity
|
|
62
|
+
|
|
63
|
+
Call `receiz_bearer_asset_claim_plan` with `{ artifactBase64, filename, mimeType }`, where the bytes are the complete sealed artifact. Require the exact confirmation digest, then call `receiz_bearer_asset_claim_execute` with `{ planDigest, confirmation }`.
|
|
64
|
+
|
|
65
|
+
The active MCP path calls `client.artifacts.verifyAndOpen(completeFile)`, then `client.ownership.claimBearerAsset({ artifact: opened.sealedArtifact })`. It returns the newly claimed complete sealed artifact bytes and evidence, never the extracted payload.
|
|
66
|
+
|
|
67
|
+
## Emulator fixture
|
|
68
|
+
|
|
69
|
+
Run `generic-bearer-transfer` and `previous-owner-projection-invalidation` across qualifying artifact families. Require the prior ownership reference to come from carried verified proof and the output to be a native sealed artifact.
|
|
@@ -0,0 +1,4 @@
|
|
|
1
|
+
interface:
|
|
2
|
+
display_name: "Receiz Bearer Ownership"
|
|
3
|
+
short_description: "Claim from a complete sealed artifact"
|
|
4
|
+
default_prompt: "Use $receiz-bearer-ownership to verify the complete sealed artifact and return the authenticated owner's new native Record -> Seal artifact. A verified proof object is not limited to the platform that created it: any lawful platform may append authenticated ownership and history only while preserving the same immutable object identity, payload, provenance root, prior history, and unknown namespaces."
|
|
@@ -0,0 +1,14 @@
|
|
|
1
|
+
{
|
|
2
|
+
"schema": "receiz.ai-skill-contract.v108",
|
|
3
|
+
"name": "receiz-bearer-ownership",
|
|
4
|
+
"version": "108.0.0",
|
|
5
|
+
"requires": { "sdk": ">=108.0.0 <109.0.0", "mcp": ">=108.0.0 <109.0.0", "ruleset": "108.0.0", "registryDigest": "126ca9283fee4ef4c398dbcb958e861cbea191724fdab8eb08df55ff0c14bb79" },
|
|
6
|
+
"laws": ["receiz.ownership.enclosing-proof", "receiz.ownership.carried-continuity", "receiz.artifact.native-record-seal", "ownership.cross-platform-proof-object-continuity"],
|
|
7
|
+
"sdkOperations": ["artifacts.verifyAndOpen", "ownership.claimBearerAsset", "artifacts.download"],
|
|
8
|
+
"allowedTools": ["receiz_bearer_asset_claim_plan", "receiz_bearer_asset_claim_execute"],
|
|
9
|
+
"requiredScopes": ["receiz:record", "receiz:seal"],
|
|
10
|
+
"emulatorFixtures": ["generic-bearer-transfer", "previous-owner-projection-invalidation"],
|
|
11
|
+
"forbiddenOperations": ["direct-state-write", "payload-as-claim-input", "caller-owner-substitution", "caller-proof-head-prerequisite", "claim-key-prerequisite", "receipt-authority", "origin-platform-lock", "authority-bypass"],
|
|
12
|
+
"requiredEvidence": ["complete-artifact-verification", "native-record-seal", "emulator-conformance", "release-lock-pass"],
|
|
13
|
+
"maximumAutonomousAuthority": "inspect-plan-simulate"
|
|
14
|
+
}
|
|
@@ -1,11 +1,12 @@
|
|
|
1
1
|
{
|
|
2
|
-
"schema": "receiz.ai-skill-contract.
|
|
2
|
+
"schema": "receiz.ai-skill-contract.v108",
|
|
3
3
|
"name": "receiz-build-production-system",
|
|
4
|
+
"version": "108.0.0",
|
|
4
5
|
"requires": {
|
|
5
|
-
"sdk": ">=
|
|
6
|
-
"mcp": ">=
|
|
7
|
-
"ruleset": "
|
|
8
|
-
"registryDigest": "
|
|
6
|
+
"sdk": ">=108.0.0 <109.0.0",
|
|
7
|
+
"mcp": ">=108.0.0 <109.0.0",
|
|
8
|
+
"ruleset": "108.0.0",
|
|
9
|
+
"registryDigest": "126ca9283fee4ef4c398dbcb958e861cbea191724fdab8eb08df55ff0c14bb79"
|
|
9
10
|
},
|
|
10
11
|
"laws": [
|
|
11
12
|
"receiz.truth.stronger-first",
|
|
@@ -64,4 +65,3 @@
|
|
|
64
65
|
],
|
|
65
66
|
"maximumAutonomousAuthority": "inspect-plan-scaffold-test"
|
|
66
67
|
}
|
|
67
|
-
|
|
@@ -1,11 +1,12 @@
|
|
|
1
1
|
{
|
|
2
|
-
"schema": "receiz.ai-skill-contract.
|
|
2
|
+
"schema": "receiz.ai-skill-contract.v108",
|
|
3
3
|
"name": "receiz-causal-sync",
|
|
4
|
+
"version": "108.0.0",
|
|
4
5
|
"requires": {
|
|
5
|
-
"sdk": ">=
|
|
6
|
-
"mcp": ">=
|
|
7
|
-
"ruleset": "
|
|
8
|
-
"registryDigest": "
|
|
6
|
+
"sdk": ">=108.0.0 <109.0.0",
|
|
7
|
+
"mcp": ">=108.0.0 <109.0.0",
|
|
8
|
+
"ruleset": "108.0.0",
|
|
9
|
+
"registryDigest": "126ca9283fee4ef4c398dbcb958e861cbea191724fdab8eb08df55ff0c14bb79"
|
|
9
10
|
},
|
|
10
11
|
"laws": [
|
|
11
12
|
"receiz.merge.causal",
|
|
@@ -55,4 +56,3 @@
|
|
|
55
56
|
],
|
|
56
57
|
"maximumAutonomousAuthority": "inspect-plan-scaffold-test"
|
|
57
58
|
}
|
|
58
|
-
|
|
@@ -1,11 +1,12 @@
|
|
|
1
1
|
{
|
|
2
|
-
"schema": "receiz.ai-skill-contract.
|
|
2
|
+
"schema": "receiz.ai-skill-contract.v108",
|
|
3
3
|
"name": "receiz-command-builder",
|
|
4
|
+
"version": "108.0.0",
|
|
4
5
|
"requires": {
|
|
5
|
-
"sdk": ">=
|
|
6
|
-
"mcp": ">=
|
|
7
|
-
"ruleset": "
|
|
8
|
-
"registryDigest": "
|
|
6
|
+
"sdk": ">=108.0.0 <109.0.0",
|
|
7
|
+
"mcp": ">=108.0.0 <109.0.0",
|
|
8
|
+
"ruleset": "108.0.0",
|
|
9
|
+
"registryDigest": "126ca9283fee4ef4c398dbcb958e861cbea191724fdab8eb08df55ff0c14bb79"
|
|
9
10
|
},
|
|
10
11
|
"laws": [
|
|
11
12
|
"receiz.command-only-mutation",
|
|
@@ -55,4 +56,3 @@
|
|
|
55
56
|
],
|
|
56
57
|
"maximumAutonomousAuthority": "inspect-plan-scaffold-test"
|
|
57
58
|
}
|
|
58
|
-
|
|
@@ -34,7 +34,7 @@ Receiz commerce is proof-native commerce. A product page, storefront, order view
|
|
|
34
34
|
1. Name the product primitive: proof object, ownership surface, settlement primitive, public proof surface, certificate, note, receipt, or storefront projection.
|
|
35
35
|
2. Verify the product object or public proof URL before making ownership or provenance claims.
|
|
36
36
|
3. Separate product proof from checkout mechanics and receipt projection.
|
|
37
|
-
4. Use no-database patterns only when artifact truth and
|
|
37
|
+
4. Use no-database patterns only when sealed artifact truth and verified local truth remain the source of truth; SDK and MCP rails may transport or project that truth only.
|
|
38
38
|
5. Use buyer and seller language from [resources/seller-buyer-language.md](resources/seller-buyer-language.md).
|
|
39
39
|
6. Preserve explicit confirmation before checkout, transfer, certificate, note, or receipt append actions.
|
|
40
40
|
|
|
@@ -1,11 +1,12 @@
|
|
|
1
1
|
{
|
|
2
|
-
"schema": "receiz.ai-skill-contract.
|
|
2
|
+
"schema": "receiz.ai-skill-contract.v108",
|
|
3
3
|
"name": "receiz-constitutional-laws",
|
|
4
|
+
"version": "108.0.0",
|
|
4
5
|
"requires": {
|
|
5
|
-
"sdk": ">=
|
|
6
|
-
"mcp": ">=
|
|
7
|
-
"ruleset": "
|
|
8
|
-
"registryDigest": "
|
|
6
|
+
"sdk": ">=108.0.0 <109.0.0",
|
|
7
|
+
"mcp": ">=108.0.0 <109.0.0",
|
|
8
|
+
"ruleset": "108.0.0",
|
|
9
|
+
"registryDigest": "126ca9283fee4ef4c398dbcb958e861cbea191724fdab8eb08df55ff0c14bb79"
|
|
9
10
|
},
|
|
10
11
|
"laws": [
|
|
11
12
|
"receiz.registry.digest-alignment",
|
|
@@ -55,4 +56,3 @@
|
|
|
55
56
|
],
|
|
56
57
|
"maximumAutonomousAuthority": "inspect-plan-scaffold-test"
|
|
57
58
|
}
|
|
58
|
-
|
|
@@ -0,0 +1,151 @@
|
|
|
1
|
+
---
|
|
2
|
+
name: receiz-cross-app-state
|
|
3
|
+
description: Use when carrying verified namespaced account state between Receiz applications without a shared app database or identity fork.
|
|
4
|
+
---
|
|
5
|
+
|
|
6
|
+
# Receiz Cross-App State
|
|
7
|
+
|
|
8
|
+
Continue the same Receiz identity across applications by restoring portable account truth and appending isolated namespaces. Cross-app continuation is an identity primitive, not session sharing.
|
|
9
|
+
|
|
10
|
+
## Binding v108 artifact law
|
|
11
|
+
|
|
12
|
+
A Receiz artifact is the exact byte sequence returned by native Record -> Seal. The inner payload is never an acceptable substitute.
|
|
13
|
+
|
|
14
|
+
A verified proof object is not limited to the platform that created it. Any lawful platform may append authenticated ownership and history only while preserving the same immutable object identity, payload, provenance root, prior history, and unknown namespaces, then returning a complete verified proof object.
|
|
15
|
+
|
|
16
|
+
Label every byte sequence before cross-app use:
|
|
17
|
+
|
|
18
|
+
- `payload`: application bytes exposed separately only after the enclosing artifact verifies.
|
|
19
|
+
- `sealed artifact`: the indivisible SDK-issued Record -> Seal bytes carrying integrity, Signature V4, owner, claim, verify path, provenance, and payload binding.
|
|
20
|
+
|
|
21
|
+
## Required SDK artifact workflow
|
|
22
|
+
|
|
23
|
+
```ts
|
|
24
|
+
const payload = { bytes: applicationPayload, mimeType: applicationMimeType };
|
|
25
|
+
const sealedArtifact = await receiz.assets.createProofObject(
|
|
26
|
+
{ assetType: "proof_object", payload },
|
|
27
|
+
{ filename: applicationFilename, idempotencyKey },
|
|
28
|
+
);
|
|
29
|
+
const downloadEvidence = await receiz.artifacts.download(sealedArtifact);
|
|
30
|
+
const opened = await receiz.artifacts.verifyAndOpen(savedArtifactFile);
|
|
31
|
+
if (downloadEvidence.artifactSha256 !== sealedArtifact.artifactSha256) throw new Error("artifact_digest_mismatch");
|
|
32
|
+
if (opened.sealedArtifact.artifactSha256 !== sealedArtifact.artifactSha256) throw new Error("saved_artifact_mismatch");
|
|
33
|
+
if (opened.verifiedPayload.sha256 !== sealedArtifact.payloadSha256) throw new Error("payload_binding_mismatch");
|
|
34
|
+
```
|
|
35
|
+
|
|
36
|
+
Independently hash the saved bytes and require equality with `sealedArtifact.artifactSha256`. Require `verification.ok`, `integrity.ok`, carrier `native-record-seal`, Signature V4, owner, claim, and verify-path agreement. Reopen the exact saved file with `verifyAndOpen`, then prove a different Receiz application preserves identity, cards, history, receipts, and unknown namespaces. Current exports use native Record -> Seal; verified legacy artifacts remain read-compatible only.
|
|
37
|
+
|
|
38
|
+
## Twelve-step artifact workflow
|
|
39
|
+
|
|
40
|
+
1. Label the input bytes as `payload`; never call them an artifact.
|
|
41
|
+
2. Load the active signed v108 registry and `ARTIFACT-001` through `ARTIFACT-010`.
|
|
42
|
+
3. Call `receiz.assets.createProofObject` so Receiz.com performs native Record -> Seal.
|
|
43
|
+
4. Require an SDK-issued `receiz.native-record-seal`; failure returns no artifact and no payload fallback.
|
|
44
|
+
5. Require complete enclosing-artifact verification, integrity, Signature V4, owner, claim, verify path, and payload binding.
|
|
45
|
+
6. Call `receiz.artifacts.download` with only that SDK-issued sealed artifact.
|
|
46
|
+
7. Independently hash the exact saved artifact bytes without repacking or relabeling them.
|
|
47
|
+
8. Require the saved artifact digest to equal the SDK-issued artifact digest.
|
|
48
|
+
9. Reopen the exact saved file through `receiz.artifacts.verifyAndOpen` before payload extraction.
|
|
49
|
+
10. Pass only `opened.verifiedPayload.bytes` to domain parsers and preserve unknown namespaces.
|
|
50
|
+
11. Exercise a different Receiz application projection and prove identity, ownership history, namespaces, and byte round trip remain intact.
|
|
51
|
+
12. Record every production-ready evidence field below and refuse completion if any field is absent or failing.
|
|
52
|
+
|
|
53
|
+
When MCP is available, use only these current artifact tools; each remains subordinate to the SDK and enclosing proof:
|
|
54
|
+
|
|
55
|
+
- `receiz_artifact_record_seal_plan`
|
|
56
|
+
- `receiz_artifact_record_seal_execute`
|
|
57
|
+
- `receiz_artifact_verify`
|
|
58
|
+
- `receiz_artifact_extract_verified`
|
|
59
|
+
- `receiz_artifact_round_trip_check`
|
|
60
|
+
- `receiz_artifact_explain`
|
|
61
|
+
|
|
62
|
+
## Artifact prohibitions
|
|
63
|
+
|
|
64
|
+
- Never download an unsealed payload fallback.
|
|
65
|
+
- Never call an inner payload a Receiz artifact.
|
|
66
|
+
- Never relabel payload bytes as a Receiz artifact.
|
|
67
|
+
- Never repack, wrap, recompress, or modify native Record -> Seal bytes.
|
|
68
|
+
- Never treat shape validation as artifact verification.
|
|
69
|
+
- Never delete unknown cross-application namespaces.
|
|
70
|
+
- Never rewrite immutable ownership or provenance history.
|
|
71
|
+
- Never weaken a failing test to accept payload-only continuity.
|
|
72
|
+
- Never claim success from UI rendering alone.
|
|
73
|
+
|
|
74
|
+
## Production-ready evidence
|
|
75
|
+
|
|
76
|
+
Refuse to call the artifact production-ready when any field is absent or failing:
|
|
77
|
+
|
|
78
|
+
```md
|
|
79
|
+
SDK version:
|
|
80
|
+
Registry digest:
|
|
81
|
+
Artifact law version:
|
|
82
|
+
Artifact carrier:
|
|
83
|
+
Signature version:
|
|
84
|
+
Artifact digest:
|
|
85
|
+
Payload digest:
|
|
86
|
+
Owner and claim binding:
|
|
87
|
+
Independent verification result:
|
|
88
|
+
Cross-platform round-trip result:
|
|
89
|
+
Legacy compatibility result:
|
|
90
|
+
Release-lock result:
|
|
91
|
+
```
|
|
92
|
+
|
|
93
|
+
## Exact SDK operation
|
|
94
|
+
|
|
95
|
+
Use the current root SDK identity verifier and complete-artifact custody methods. Do not import the historical v107 continuity client.
|
|
96
|
+
|
|
97
|
+
```ts
|
|
98
|
+
import { createReceizClient } from "@receiz/sdk";
|
|
99
|
+
|
|
100
|
+
const receiz = createReceizClient({ accessToken });
|
|
101
|
+
const identityFile = await receiz.identity.readArtifact(identityArtifactFile);
|
|
102
|
+
const account = await receiz.identity.projectAccount(identityFile);
|
|
103
|
+
const carried = await receiz.artifacts.verifyAndOpen(crossAppStateArtifactFile);
|
|
104
|
+
|
|
105
|
+
const next = await receiz.assets.createProofObject(
|
|
106
|
+
{
|
|
107
|
+
assetType: "proof_object",
|
|
108
|
+
payload: { bytes: nextNamespacedStateBytes, mimeType: "application/json" },
|
|
109
|
+
},
|
|
110
|
+
{ filename: "cross-app-state.receiz", idempotencyKey },
|
|
111
|
+
);
|
|
112
|
+
await receiz.artifacts.download(next);
|
|
113
|
+
```
|
|
114
|
+
|
|
115
|
+
`nextNamespacedStateBytes` must retain the admitted `account.owner.uid`, cite `carried.sealedArtifact.artifactSha256`, preserve every unknown namespace, and append only the authorized application namespace. Native Record -> Seal creates the next proof object.
|
|
116
|
+
|
|
117
|
+
## Required authority
|
|
118
|
+
|
|
119
|
+
The verified Record, Seal, Key, or Vault supplies local identity authority. Native reseal requires the admitted session or delegated Record and Seal scopes. An application may append only its explicitly allowed namespace.
|
|
120
|
+
|
|
121
|
+
## Required proof object
|
|
122
|
+
|
|
123
|
+
Require the complete identity artifact and complete cross-application state artifact. Verify both enclosing objects before projection. An inner JSON document, database row, receipt, or proof head cannot replace either artifact.
|
|
124
|
+
|
|
125
|
+
## Deterministic behavior
|
|
126
|
+
|
|
127
|
+
Bind idempotency to the application namespace, prior artifact digest, next payload digest, and admitted UID. Preserve exact prior bytes and immutable history. Every changed state creates a new artifact.
|
|
128
|
+
|
|
129
|
+
## Offline behavior
|
|
130
|
+
|
|
131
|
+
Project verified portable state immediately in the destination application. Persist the exact artifact bytes. Background synchronization may append verified additions later without remounting or downgrading the settled surface.
|
|
132
|
+
|
|
133
|
+
## Conflict behavior
|
|
134
|
+
|
|
135
|
+
Reject unauthorized or previously occupied namespaces. Preserve every conflicting verified artifact, stop the affected namespace lane, and require a declared append resolution that cites both histories.
|
|
136
|
+
|
|
137
|
+
## Result verification
|
|
138
|
+
|
|
139
|
+
Require the same admitted UID, exact downloaded bytes, native Record -> Seal continuity, Signature V4, owner/claim/path binding, payload binding, and independent verification in the destination application.
|
|
140
|
+
|
|
141
|
+
## User confirmation
|
|
142
|
+
|
|
143
|
+
Show the admitted UID, prior artifact digest, destination namespace, data categories, next payload digest, and exact Record -> Seal plan. Require confirmation before creating the next artifact.
|
|
144
|
+
|
|
145
|
+
## MCP parity
|
|
146
|
+
|
|
147
|
+
Call `receiz_artifact_verify` and `receiz_artifact_extract_verified` for input, require exact digest confirmation through `receiz_artifact_record_seal_plan`, execute with `receiz_artifact_record_seal_execute`, and finish with `receiz_artifact_round_trip_check`. MCP cannot read or rewrite another application namespace directly.
|
|
148
|
+
|
|
149
|
+
## Emulator fixture
|
|
150
|
+
|
|
151
|
+
Run current native artifact round-trip, destination reopen, namespace-preservation, and artifact-substitution rejection contracts. Historical v107 reconcile fixtures are archival evidence only.
|