@receiz/ai-skills 102.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.
Files changed (86) hide show
  1. package/README.md +45 -0
  2. package/package.json +31 -0
  3. package/receiz-builder-skill/SKILL.md +92 -0
  4. package/receiz-builder-skill/examples/create-marketplace.md +10 -0
  5. package/receiz-builder-skill/examples/create-pack-app.md +12 -0
  6. package/receiz-builder-skill/examples/create-profile-vault.md +5 -0
  7. package/receiz-builder-skill/examples/create-proof-page.md +5 -0
  8. package/receiz-builder-skill/examples/create-storefront.md +5 -0
  9. package/receiz-builder-skill/resources/app-patterns.md +29 -0
  10. package/receiz-builder-skill/resources/deployment-checklist.md +13 -0
  11. package/receiz-builder-skill/resources/generated-code-rules.md +27 -0
  12. package/receiz-builder-skill/resources/no-db-pattern.md +34 -0
  13. package/receiz-builder-skill/resources/proof-native-ui-patterns.md +29 -0
  14. package/receiz-builder-skill/resources/sdk-quickstart.md +68 -0
  15. package/receiz-commerce-skill/SKILL.md +95 -0
  16. package/receiz-commerce-skill/examples/create-no-db-store.md +15 -0
  17. package/receiz-commerce-skill/examples/create-product-page.md +25 -0
  18. package/receiz-commerce-skill/examples/explain-receiz-commerce.md +14 -0
  19. package/receiz-commerce-skill/examples/verify-product-ownership.md +20 -0
  20. package/receiz-commerce-skill/resources/commerce-object-model.md +44 -0
  21. package/receiz-commerce-skill/resources/conversion-copy-patterns.md +23 -0
  22. package/receiz-commerce-skill/resources/order-and-receipt-boundaries.md +29 -0
  23. package/receiz-commerce-skill/resources/product-proof-flow.md +26 -0
  24. package/receiz-commerce-skill/resources/seller-buyer-language.md +26 -0
  25. package/receiz-commerce-skill/resources/storefront-patterns.md +33 -0
  26. package/receiz-distribution-skill/SKILL.md +94 -0
  27. package/receiz-distribution-skill/examples/create-bar-flyer-copy.md +18 -0
  28. package/receiz-distribution-skill/examples/create-restaurant-activation.md +20 -0
  29. package/receiz-distribution-skill/examples/create-venue-one-pager.md +15 -0
  30. package/receiz-distribution-skill/examples/explain-pack-derby.md +9 -0
  31. package/receiz-distribution-skill/resources/affiliate-boundaries.md +23 -0
  32. package/receiz-distribution-skill/resources/conversion-language.md +20 -0
  33. package/receiz-distribution-skill/resources/pack-derby-model.md +19 -0
  34. package/receiz-distribution-skill/resources/qr-activation-flow.md +24 -0
  35. package/receiz-distribution-skill/resources/staff-training-script.md +17 -0
  36. package/receiz-distribution-skill/resources/venue-playbook.md +25 -0
  37. package/receiz-mcp-agent-skill/SKILL.md +89 -0
  38. package/receiz-mcp-agent-skill/examples/agent-append-proof.md +11 -0
  39. package/receiz-mcp-agent-skill/examples/agent-build-app.md +10 -0
  40. package/receiz-mcp-agent-skill/examples/agent-inspect-vault.md +8 -0
  41. package/receiz-mcp-agent-skill/examples/agent-verify-object.md +3 -0
  42. package/receiz-mcp-agent-skill/resources/action-confirmation-rules.md +22 -0
  43. package/receiz-mcp-agent-skill/resources/agent-operating-rules.md +28 -0
  44. package/receiz-mcp-agent-skill/resources/auth-boundaries.md +21 -0
  45. package/receiz-mcp-agent-skill/resources/mcp-tool-map.md +61 -0
  46. package/receiz-mcp-agent-skill/resources/response-templates.md +38 -0
  47. package/receiz-mcp-agent-skill/resources/safe-tool-calling.md +45 -0
  48. package/receiz-offline-verifier-skill/SKILL.md +91 -0
  49. package/receiz-offline-verifier-skill/examples/debug-verification-failure.md +17 -0
  50. package/receiz-offline-verifier-skill/examples/explain-offline-proof.md +9 -0
  51. package/receiz-offline-verifier-skill/examples/verify-offline-asset.md +19 -0
  52. package/receiz-offline-verifier-skill/resources/airplane-mode-principle.md +15 -0
  53. package/receiz-offline-verifier-skill/resources/artifact-over-server.md +22 -0
  54. package/receiz-offline-verifier-skill/resources/offline-verification-law.md +17 -0
  55. package/receiz-offline-verifier-skill/resources/security-boundaries.md +20 -0
  56. package/receiz-offline-verifier-skill/resources/verifier-flow.md +25 -0
  57. package/receiz-proof-skill/SKILL.md +98 -0
  58. package/receiz-proof-skill/examples/verify-card.md +21 -0
  59. package/receiz-proof-skill/examples/verify-pack.md +14 -0
  60. package/receiz-proof-skill/examples/verify-post.md +7 -0
  61. package/receiz-proof-skill/examples/verify-product.md +7 -0
  62. package/receiz-proof-skill/examples/verify-vault.md +7 -0
  63. package/receiz-proof-skill/resources/failure-modes.md +31 -0
  64. package/receiz-proof-skill/resources/mcp-tool-map.md +49 -0
  65. package/receiz-proof-skill/resources/output-templates.md +56 -0
  66. package/receiz-proof-skill/resources/proof-object-model.md +30 -0
  67. package/receiz-proof-skill/resources/receiz-laws.md +41 -0
  68. package/receiz-proof-skill/resources/sdk-reference.md +80 -0
  69. package/receiz-proof-skill/resources/verification-flow.md +38 -0
  70. package/receiz-skill-bundle/SKILL.md +87 -0
  71. package/receiz-skill-bundle/resources/canonical-receiz-language.md +46 -0
  72. package/receiz-skill-bundle/resources/combined-agent-behavior.md +35 -0
  73. package/receiz-skill-bundle/resources/skill-routing.md +15 -0
  74. package/receiz-skill-bundle/resources/when-to-use-each-skill.md +29 -0
  75. package/receiz-sports-card-skill/SKILL.md +97 -0
  76. package/receiz-sports-card-skill/examples/explain-card-market.md +18 -0
  77. package/receiz-sports-card-skill/examples/explain-geo-appeal.md +9 -0
  78. package/receiz-sports-card-skill/examples/explain-live-event-card.md +18 -0
  79. package/receiz-sports-card-skill/examples/explain-pack-opening.md +10 -0
  80. package/receiz-sports-card-skill/examples/explain-player-card.md +19 -0
  81. package/receiz-sports-card-skill/resources/card-memory-law.md +23 -0
  82. package/receiz-sports-card-skill/resources/game-surface-patterns.md +26 -0
  83. package/receiz-sports-card-skill/resources/live-event-append-flow.md +19 -0
  84. package/receiz-sports-card-skill/resources/mlb-proof-language.md +24 -0
  85. package/receiz-sports-card-skill/resources/rarity-and-event-language.md +25 -0
  86. package/receiz-sports-card-skill/resources/sports-card-object-model.md +22 -0
@@ -0,0 +1,61 @@
1
+ # MCP Tool Map
2
+
3
+ Source: `packages/receiz-mcp-server/src/index.ts`.
4
+
5
+ ## Diagnostics And Setup
6
+
7
+ - `receiz_doctor`: SDK doctor for app/tenant diagnostics.
8
+ - `receiz_capabilities`: inspect SDK capability readiness.
9
+ - `receiz_required_scopes`: return stable scope constants by rail.
10
+ - `receiz_runtime_blueprint`: return app runtime blueprint.
11
+ - `receiz_authorize_url`: build Connect/OIDC authorize URL.
12
+ - `receiz_mcp_login`: return delegated agent-token setup path.
13
+ - `receiz_ensure_tenant_session`: build tenant customer-session entry path.
14
+
15
+ ## App-State And Store
16
+
17
+ - `receiz_app_state_publish`: publish durable public app-state projection. Delegated write.
18
+ - `receiz_app_state_resolve`: resolve by URL, host, namespace, ID, or creator.
19
+ - `receiz_app_state_by_url`
20
+ - `receiz_app_state_by_creator`
21
+ - `receiz_app_state_by_namespace`
22
+ - `receiz_app_state_by_id`
23
+ - `receiz_public_store_publish`: publish typed public-store projection. Delegated write.
24
+ - `receiz_public_store_resolve`: resolve public-store projection.
25
+
26
+ ## Resolution, Inspection, And Proof
27
+
28
+ - `receiz_inspect_offline_file`: shape inspection only; never a verified artifact verdict.
29
+ - `receiz_asset_by_url`
30
+ - `receiz_asset_by_id`
31
+ - `receiz_inspect_proof_object`
32
+ - `receiz_proof_query`: delegated proof query projection.
33
+
34
+ Use SDK `verification.verifyArtifact(file)` for verification; it requires enclosing integrity and ownership continuity.
35
+
36
+ ## Sports, Wallet, World
37
+
38
+ - `receiz_pitch_proof_by_witness_id`
39
+ - `receiz_card_history`
40
+ - `receiz_sports_conformance`
41
+ - `receiz_wallet_public_ledger`
42
+ - `receiz_action_ledger`
43
+ - `receiz_world_public_snapshot`
44
+
45
+ ## Preview And Sandbox
46
+
47
+ - `receiz_transfer_preview`: preview only.
48
+ - `receiz_transfer_requires_confirmation`: confirmation policy.
49
+ - `receiz_pack_open_preview`: preview only.
50
+ - `receiz_marketplace_template_generate`: template envelope only.
51
+ - `receiz_sandbox_seed_store`: deterministic sandbox store.
52
+ - `receiz_sandbox_checkout`: deterministic sandbox checkout.
53
+
54
+ ## Resource Templates
55
+
56
+ - `receiz://asset/{id}`
57
+ - `receiz://proof/{id}`
58
+ - `receiz://pitch/{witnessId}`
59
+ - `receiz://store/{tenantHost}`
60
+ - `receiz://sdk/docs`
61
+ - `receiz://schemas/proof-object-v1`
@@ -0,0 +1,38 @@
1
+ # Response Templates
2
+
3
+ ## Tool Success
4
+
5
+ ```md
6
+ Tool:
7
+ Action class:
8
+ Source:
9
+ Primitive:
10
+ Result:
11
+ Authority boundary: MCP is tooling below Receiz proof truth.
12
+ What is proven:
13
+ What is not proven:
14
+ Next safe action:
15
+ ```
16
+
17
+ ## Tool Failure
18
+
19
+ ```md
20
+ Tool:
21
+ Action class:
22
+ Failure:
23
+ Inputs used:
24
+ What can still be reasoned:
25
+ What cannot be claimed:
26
+ Required next evidence:
27
+ ```
28
+
29
+ ## Confirmation Request
30
+
31
+ ```md
32
+ Before I run this write action, confirm:
33
+ Tool:
34
+ Primitive affected:
35
+ Inputs:
36
+ Expected effect:
37
+ Risk:
38
+ ```
@@ -0,0 +1,45 @@
1
+ # Safe Tool Calling
2
+
3
+ ## Read-Only Tools
4
+
5
+ Usually safe after input validation:
6
+
7
+ - `receiz_doctor`
8
+ - `receiz_capabilities`
9
+ - `receiz_required_scopes`
10
+ - `receiz_app_state_resolve`
11
+ - `receiz_app_state_by_url`
12
+ - `receiz_app_state_by_creator`
13
+ - `receiz_app_state_by_namespace`
14
+ - `receiz_app_state_by_id`
15
+ - `receiz_public_store_resolve`
16
+ - `receiz_inspect_offline_file`
17
+ - `receiz_asset_by_url`
18
+ - `receiz_asset_by_id`
19
+ - `receiz_inspect_proof_object`
20
+ - `receiz_wallet_public_ledger`
21
+ - `receiz_action_ledger`
22
+ - `receiz_sports_conformance`
23
+ - `receiz_world_public_snapshot`
24
+
25
+ ## Preview-Only Tools
26
+
27
+ These do not mutate proof, ownership, or settlement state:
28
+
29
+ - `receiz_transfer_preview`
30
+ - `receiz_transfer_requires_confirmation`
31
+ - `receiz_pack_open_preview`
32
+ - `receiz_marketplace_template_generate`
33
+ - `receiz_runtime_blueprint`
34
+ - `receiz_sandbox_seed_store`
35
+ - `receiz_sandbox_checkout`
36
+
37
+ ## Write Or Delegated Tools
38
+
39
+ Require explicit user confirmation and delegated runtime authority:
40
+
41
+ - `receiz_app_state_publish`
42
+ - `receiz_public_store_publish`
43
+ - `receiz_proof_query` when using delegated private proof rails
44
+
45
+ If a host adds more write tools later, classify by effect, not by name.
@@ -0,0 +1,91 @@
1
+ ---
2
+ name: receiz-offline-verifier-skill
3
+ description: Use when an agent must verify, explain, debug, or build Receiz offline verification for local files, sealed artifacts, manifests, embedded proof, airplane-mode workflows, or artifact-over-server truth boundaries.
4
+ ---
5
+
6
+ # receiz-offline-verifier-skill
7
+
8
+ Offline verification is a Receiz primitive. It verifies artifact truth without requiring the server, database, session, or marketplace to answer first.
9
+
10
+ ## When To Use This Skill
11
+
12
+ - Use for local proof files, sealed artifacts, offline verifier flows, airplane-mode explanations, artifact-over-server questions, and verification failure debugging.
13
+ - Use when the user asks whether a Receiz object remains verifiable without network access.
14
+ - Use before building local verifier UI or offline proof diagnostics.
15
+
16
+ ## When Not To Use This Skill
17
+
18
+ - Do not use to publish, transfer, sell, or append proof. Use `receiz-mcp-agent-skill` for writes.
19
+ - Do not use for commerce language unless paired with `receiz-commerce-skill`.
20
+ - Do not use to bypass access controls or expose private payloads.
21
+
22
+ ## Core Receiz Laws
23
+
24
+ - Offline proof is not fallback mode. It is a proof primitive.
25
+ - Artifact truth outranks server, database, session, and UI state.
26
+ - Verify the enclosing artifact before trusting embedded subpayloads.
27
+ - A failed server lookup does not make sealed artifact truth false.
28
+ - Never treat a database, server, marketplace, UI, model response, or cache as final authority.
29
+ - If offline verification fails, report the exact failed boundary.
30
+ - Read [resources/offline-verification-law.md](resources/offline-verification-law.md) before explaining offline proof.
31
+
32
+ ## Required Behavior
33
+
34
+ 1. Identify artifact type and strongest available local proof.
35
+ 2. Verify local bytes or manifest with SDK/MCP/local verifier mechanics.
36
+ 3. Validate enclosing artifact before parsing embedded payloads.
37
+ 4. Report pass, fail, or incomplete evidence with exact boundary.
38
+ 5. Keep network checks as append or comparison, never as stronger truth than sealed proof.
39
+ 6. Use [resources/verifier-flow.md](resources/verifier-flow.md) for the step order.
40
+
41
+ ## Forbidden Behavior
42
+
43
+ - Do not call offline proof a fallback, cache, preview, or degraded mode.
44
+ - Do not require a server round trip before admitting known artifact truth.
45
+ - Do not trust an embedded subpayload when the enclosing artifact fails.
46
+ - Do not expose private identity, recovery, or sealed private payload contents.
47
+ - Do not claim failure globally when only a specific verifier boundary failed.
48
+
49
+ ## MCP Usage Rules
50
+
51
+ Use `receiz_inspect_offline_file` for local JSON manifest shape inspection and `receiz_inspect_proof_object` or `receiz_asset_by_id` when public proof resolution is available. MCP inspection is not verification. Use SDK `verification.verifyArtifact(file)` or the downloadable verifier for the same integrity-and-continuity verdict. If MCP is unavailable, name the exact local SDK or file evidence still available.
52
+
53
+ ## SDK Usage Rules
54
+
55
+ Use `receiz.verification.verifyArtifact(file)`, `assertReceizProofBundle`, `assertReceizAssetManifest`, `assertReceizSportsCardManifest`, `readReceizIdentityArtifact`, `verifyReceizIdentityLoginProof`, proof register helpers, proof memory helpers, and offline proof queue helpers. See [resources/artifact-over-server.md](resources/artifact-over-server.md).
56
+
57
+ ## Output Format
58
+
59
+ Use this format:
60
+
61
+ ```md
62
+ ## Offline Verification
63
+ Artifact:
64
+ Primitive:
65
+ Verification mode:
66
+ Strongest source of truth:
67
+ Enclosing proof:
68
+ Embedded payload:
69
+ Result:
70
+ Failed boundary:
71
+ Network dependency:
72
+ Safe next action:
73
+ ```
74
+
75
+ ## Safety And Security Boundaries
76
+
77
+ Never print private keys, passphrases, bearer tokens, private identity artifact payloads, or recovery material. Do not upload private artifacts unless the user explicitly asks and the target verifier is trusted. Offline verification may inspect local proof, but private contents remain private.
78
+
79
+ ## Examples
80
+
81
+ - [Verify offline asset](examples/verify-offline-asset.md)
82
+ - [Explain offline proof](examples/explain-offline-proof.md)
83
+ - [Debug verification failure](examples/debug-verification-failure.md)
84
+
85
+ Load resources as needed:
86
+
87
+ - [Offline verification law](resources/offline-verification-law.md)
88
+ - [Verifier flow](resources/verifier-flow.md)
89
+ - [Artifact over server](resources/artifact-over-server.md)
90
+ - [Airplane mode principle](resources/airplane-mode-principle.md)
91
+ - [Security boundaries](resources/security-boundaries.md)
@@ -0,0 +1,17 @@
1
+ # Debug Verification Failure
2
+
3
+ ## Agent Steps
4
+
5
+ 1. Identify the failed verifier step.
6
+ 2. Separate file read failure, schema failure, integrity failure, seal failure, embedded payload failure, and network absence.
7
+ 3. State whether any verified truth remains.
8
+ 4. Give the next safe diagnostic step.
9
+
10
+ ## Output
11
+
12
+ ```md
13
+ Failure class:
14
+ Boundary:
15
+ Verified truth still present:
16
+ Next diagnostic:
17
+ ```
@@ -0,0 +1,9 @@
1
+ # Explain Offline Proof
2
+
3
+ Use this explanation:
4
+
5
+ ```md
6
+ Offline proof means the artifact carries verification material. The server can help discover additions or public witness state, but the sealed artifact remains the stronger truth when verified.
7
+ ```
8
+
9
+ Do not describe offline proof as degraded mode.
@@ -0,0 +1,19 @@
1
+ # Verify Offline Asset
2
+
3
+ ## Agent Steps
4
+
5
+ 1. Read the local file or manifest.
6
+ 2. Identify the enclosing proof boundary.
7
+ 3. Run SDK `verification.verifyArtifact(file)` for verification; use `receiz_inspect_offline_file` only for manifest shape inspection.
8
+ 4. Report exact pass or failure.
9
+ 5. Avoid network dependency unless comparison is requested.
10
+
11
+ ## Output
12
+
13
+ ```md
14
+ Artifact:
15
+ Verification result:
16
+ Source of truth:
17
+ Failed boundary:
18
+ Network required:
19
+ ```
@@ -0,0 +1,15 @@
1
+ # Airplane Mode Principle
2
+
3
+ Receiz proof should remain legible when network access is absent.
4
+
5
+ ## Agent Rule
6
+
7
+ When asked about airplane mode, explain that proof objects can carry their own verification material. The network may add public witness context, but the artifact does not become meaningless when offline.
8
+
9
+ ## UI Rule
10
+
11
+ Offline verifier UI must show known verified truth immediately. It may show a separate area for network comparison when connectivity returns.
12
+
13
+ ## Failure Rule
14
+
15
+ If a verification step needs network data, state that exact step. Do not say the whole artifact cannot be verified unless the artifact proof itself fails.
@@ -0,0 +1,22 @@
1
+ # Artifact Over Server
2
+
3
+ Artifact truth outranks server confirmation.
4
+
5
+ ## Correct Order
6
+
7
+ 1. Verify artifact.
8
+ 2. Parse proof payload.
9
+ 3. Project identity, ownership, provenance, or settlement state.
10
+ 4. Optionally compare to server or public registry.
11
+ 5. Append verified additions when discovered.
12
+
13
+ ## Incorrect Order
14
+
15
+ - Ask the database whether a local sealed proof is real before verifying the proof.
16
+ - Treat server absence as artifact invalidity.
17
+ - Replace artifact proof with session state.
18
+ - Call verified local truth cache.
19
+
20
+ ## Agent Reporting
21
+
22
+ If server and artifact disagree, say which layer is stronger and which projection needs correction.
@@ -0,0 +1,17 @@
1
+ # Offline Verification Law
2
+
3
+ Offline verification is a Receiz proof primitive.
4
+
5
+ ## Law
6
+
7
+ - Sealed artifact truth can be verified without waiting for a server.
8
+ - Known verified local truth must be used immediately.
9
+ - Network checks may append, compare, or discover additions.
10
+ - Network checks may not erase sealed local proof.
11
+ - Durable local truth is not cache.
12
+
13
+ ## Required Language
14
+
15
+ Say "offline proof", "sealed artifact truth", "local verified truth", and "artifact-over-server" when those boundaries apply.
16
+
17
+ Do not say "fallback", "best effort", "cached copy", or "offline preview" as product truth.
@@ -0,0 +1,20 @@
1
+ # Security Boundaries
2
+
3
+ Offline verification may inspect proof, but it must protect private material.
4
+
5
+ ## Never Print
6
+
7
+ - Bearer tokens.
8
+ - Private keys.
9
+ - Passphrases.
10
+ - Private identity artifact payloads.
11
+ - Recovery material.
12
+ - Hidden private proof payloads.
13
+
14
+ ## Safe Output
15
+
16
+ Report hashes, public proof IDs, public URLs, schema names, verification status, and exact failure classes when those fields are not secret.
17
+
18
+ ## Upload Rule
19
+
20
+ Do not upload private artifacts to an external verifier unless the user explicitly requests it and accepts the target boundary.
@@ -0,0 +1,25 @@
1
+ # Verifier Flow
2
+
3
+ ## Local Verification
4
+
5
+ 1. Read the artifact or manifest.
6
+ 2. Identify the enclosing proof boundary.
7
+ 3. Validate schema and required proof fields.
8
+ 4. Verify integrity, signature, seal, witness, or register material when present.
9
+ 5. Project embedded payload only after the enclosing proof passes.
10
+ 6. Report exact missing or failed evidence.
11
+
12
+ ## Online Comparison
13
+
14
+ Use online checks only to compare public proof state, discover appends, or inspect public witness surfaces. Do not make online response the stronger truth.
15
+
16
+ ## Failure Classes
17
+
18
+ - Missing file.
19
+ - Invalid schema.
20
+ - Integrity mismatch.
21
+ - Signature or seal failure.
22
+ - Enclosing proof failure.
23
+ - Embedded payload mismatch.
24
+ - Unknown public proof route.
25
+ - Network unavailable.
@@ -0,0 +1,98 @@
1
+ ---
2
+ name: receiz-proof-skill
3
+ description: Use when an agent must verify, inspect, explain, or report on Receiz proof objects, cards, packs, products, posts, receipts, vaults, profiles, marketplace listings, live sports objects, or offline proof artifacts.
4
+ ---
5
+
6
+ # receiz-proof-skill
7
+
8
+ Receiz proof inspection starts from the artifact, manifest, proof bundle, verified append, or admitted local register. Do not start from a database row, marketplace card, UI state, or model memory.
9
+
10
+ ## When To Use This Skill
11
+
12
+ - Use for Card, Pack, Product, Post, Receipt, Vault, Profile, marketplace listing, live sports object, event proof, or offline artifact verification.
13
+ - Use when asked "is this real", "who owns this", "what proves this", "what changed", "can I trust this", or "what can be safely done next".
14
+ - Use before any skill that wants to create, publish, sell, transfer, inspect, or explain a Receiz object.
15
+
16
+ ## When Not To Use This Skill
17
+
18
+ - Do not use as the only skill for building a new app. Use `receiz-builder-skill` after proof boundaries are named.
19
+ - Do not use to execute live MCP write actions. Use `receiz-mcp-agent-skill` for tool calls and confirmation rules.
20
+ - Do not use to invent missing proof. Missing proof must be reported as missing truth or appended through an existing Receiz rail.
21
+
22
+ ## Core Receiz Laws
23
+
24
+ - A Receiz object is a proof-carrying artifact. Its witnessed history is the truth boundary.
25
+ - Verify before claiming.
26
+ - Never invent ownership, witness IDs, rarity, transfer history, or verification status.
27
+ - Never treat a database, server, marketplace, UI, model response, or cache as final authority.
28
+ - Never mutate witnessed history. Append new truth only.
29
+ - If a view is wrong, rebuild the projection from witnessed history.
30
+ - If history is missing, append the missing truth through an existing Receiz primitive.
31
+ - Read [resources/receiz-laws.md](resources/receiz-laws.md) before explaining product truth.
32
+
33
+ ## Required Behavior
34
+
35
+ 1. Name the primitive: proof object, artifact system, ownership surface, settlement primitive, identity primitive, public proof surface, offline proof, or sports event proof.
36
+ 2. Name the strongest source of truth available.
37
+ 3. Use MCP reads or local manifest validators only for resolution and inspection; use SDK `verification.verifyArtifact(file)` for artifact verification.
38
+ 4. Separate proven facts from absent or unverified facts.
39
+ 5. Use the standard output in [resources/output-templates.md](resources/output-templates.md).
40
+ 6. Keep projection language lower than artifact truth.
41
+
42
+ ## Forbidden Behavior
43
+
44
+ - Do not say an object is verified because a server, UI, marketplace, or model says so.
45
+ - Do not fill unknown fields from pattern, memory, copy, filename, price, team, user handle, or visual similarity.
46
+ - Do not call an implemented proof object a card, content item, database row, metadata wrapper, or generic share.
47
+ - Do not treat a self-hashable subpayload as authority when it sits inside a stronger artifact.
48
+ - Do not change proof language to soften an implemented primitive.
49
+
50
+ ## MCP Usage Rules
51
+
52
+ Use MCP only when a live agent host has the Receiz MCP server available. MCP resolution and inspection are not artifact verification. Use `receiz_inspect_offline_file` for local JSON shape inspection, `receiz_asset_by_url` for public proof resolution, `receiz_card_history` for Sports card memory, and `receiz_pitch_proof_by_witness_id` for pitch witnesses. Use SDK `verification.verifyArtifact(file)` for the integrity-and-continuity verdict. If the MCP tool is unavailable, say what can be reasoned from available data and what still needs live verification. See [resources/mcp-tool-map.md](resources/mcp-tool-map.md).
53
+
54
+ ## SDK Usage Rules
55
+
56
+ Use SDK validators and projectors for local proof objects: `assertReceizAssetManifest`, `assertReceizSportsCardManifest`, `assertReceizWebhookEvent`, `projectReceizAssetManifest`, `projectReceizSportsCardManifest`, `createReceizProofMemory`, and `receizProofMemoryAdditionsQuery`. Use `receiz.verification.verifyArtifact(file)` when artifact bytes need Receiz verification. See [resources/sdk-reference.md](resources/sdk-reference.md).
57
+
58
+ ## Output Format
59
+
60
+ Use the verified object format exactly:
61
+
62
+ ```md
63
+ ## Verified Object
64
+ Object:
65
+ Status:
66
+ Identity:
67
+ Current controller / owner:
68
+ Proof present:
69
+ Witness history:
70
+ Provenance:
71
+ Media:
72
+ Transfer state:
73
+ What is proven:
74
+ What is not proven:
75
+ Safe next action:
76
+ ```
77
+
78
+ ## Safety And Security Boundaries
79
+
80
+ Read-only verification is safe when it does not expose private payloads. Writes, transfers, settlement actions, publishing, or proof appends require explicit user confirmation and an existing Receiz write rail. Never request or print private keys, bearer tokens, passphrases, private proof material, or hidden recovery payloads.
81
+
82
+ ## Examples
83
+
84
+ - [Verify card](examples/verify-card.md)
85
+ - [Verify product](examples/verify-product.md)
86
+ - [Verify post](examples/verify-post.md)
87
+ - [Verify pack](examples/verify-pack.md)
88
+ - [Verify vault](examples/verify-vault.md)
89
+
90
+ Load resources as needed:
91
+
92
+ - [Receiz laws](resources/receiz-laws.md)
93
+ - [Proof object model](resources/proof-object-model.md)
94
+ - [Verification flow](resources/verification-flow.md)
95
+ - [Output templates](resources/output-templates.md)
96
+ - [Failure modes](resources/failure-modes.md)
97
+ - [MCP tool map](resources/mcp-tool-map.md)
98
+ - [SDK reference](resources/sdk-reference.md)
@@ -0,0 +1,21 @@
1
+ # Verify Card
2
+
3
+ Use `assertReceizSportsCardManifest` or MCP `receiz_inspect_offline_file` only to inspect a local card manifest shape. Use SDK `verification.verifyArtifact(file)` for verification. Use `receiz_card_history` when the user provides local card memory or asks for append history.
4
+
5
+ Report:
6
+
7
+ ```md
8
+ ## Verified Object
9
+ Object: Sports card proof object
10
+ Status: verified, inspected, or not verified
11
+ Identity: collectible ID and claim hash from the manifest
12
+ Current controller / owner: ownership owner label only if present
13
+ Proof present: card manifest, value basis, append summary, event proof summary, links
14
+ Witness history: append and event proof summary counts
15
+ Provenance: sport, source links, verify link
16
+ Media: deterministic card image or media URL when present
17
+ Transfer state: only from ownership or appends
18
+ What is proven: fields validated from the manifest
19
+ What is not proven: any missing owner, rarity, transfer, or event data
20
+ Safe next action: inspect event proofs, resolve card history, or append missing truth
21
+ ```
@@ -0,0 +1,14 @@
1
+ # Verify Pack
2
+
3
+ A pack is an artifact/proof object when it carries stable pack identity, pack-open receipt, card claim outputs, reward lane, ownership, and append history.
4
+
5
+ Use `receiz_pack_open_preview` only for preview. A preview does not append pack truth and does not prove issuance.
6
+
7
+ A verified pack report must distinguish:
8
+
9
+ - pack preview
10
+ - issued pack
11
+ - opened pack
12
+ - claimed cards
13
+ - verified run receipt when Pack Derby issued the pack
14
+ - missing proof or missing append state
@@ -0,0 +1,7 @@
1
+ # Verify Post
2
+
3
+ Treat a Receiz post as public proof only when it carries proof object identity, public proof record, provenance, source URL, verification affordance, or admitted local truth.
4
+
5
+ Use `receiz_asset_by_url` or SDK `publicProof.byUrl` to resolve public proof rails, then SDK `verification.verifyArtifact(file)` for verification. If the post is visible only as a UI projection, report that the public proof surface still needs proof-object continuity evidence.
6
+
7
+ Never claim global visibility or canonical profile truth from an owner-only view or DB row alone.
@@ -0,0 +1,7 @@
1
+ # Verify Product
2
+
3
+ Treat a product as a proof-carrying object when it has product identity, media, provenance, ownership/custody, receipt or listing state, verify link, or public-store proof state.
4
+
5
+ Use `receiz_public_store_resolve` or SDK `publicStore.resolve` for storefront projection. Use artifact verification or manifest validation for the actual proof object.
6
+
7
+ Do not prove price, seller, stock, ownership, or purchase status from storefront copy alone.
@@ -0,0 +1,7 @@
1
+ # Verify Vault
2
+
3
+ A Receiz vault is an artifact system. It carries owned proof objects, custody state, provenance, media, action affordances, and public/private projection surfaces.
4
+
5
+ Verify vault objects by inspecting each carried proof object or admitted proof register entry. Do not reduce the vault to a content grid or account dashboard.
6
+
7
+ Report transferred-out, listed, held, certified, verified, or claimable states only when the vault proof, ownership append, or route output carries that state.
@@ -0,0 +1,31 @@
1
+ # Failure Modes
2
+
3
+ ## Hallucinated Truth
4
+
5
+ Symptom: the agent says ownership, rarity, transfer state, witness ID, or verification status without tool output or artifact evidence.
6
+
7
+ Correction: state the exact missing evidence and stop at "not proven".
8
+
9
+ ## Server-As-Authority Drift
10
+
11
+ Symptom: a DB row, API response, marketplace state, UI label, or server availability is treated as final proof.
12
+
13
+ Correction: identify it as projection and ask for the sealed artifact, manifest, verified append, public proof rail, or admitted register.
14
+
15
+ ## Projection Replaces Artifact
16
+
17
+ Symptom: display rows, generated app state, or marketplace copy overrides the proof object.
18
+
19
+ Correction: rebuild the projection from the artifact history.
20
+
21
+ ## Subpayload Overreach
22
+
23
+ Symptom: a hashable embedded payload is treated as admission, ownership, transfer, settlement, or access authority.
24
+
25
+ Correction: verify the enclosing stronger artifact first.
26
+
27
+ ## Missing Tool Honesty
28
+
29
+ Symptom: the agent says verification happened even when MCP, SDK, or artifact bytes were unavailable.
30
+
31
+ Correction: report what was inspected and what still needs live or local verification.
@@ -0,0 +1,49 @@
1
+ # Receiz MCP Tool Map For Proof Work
2
+
3
+ Source: `packages/receiz-mcp-server/src/index.ts`.
4
+
5
+ ## Authority Boundary
6
+
7
+ MCP is not authority. It calls canonical Receiz SDK/API rails and reports the source primitive. Its responses remain beneath sealed artifact truth, deterministic proof object state, verified local truth, verified register append, and authenticated SDK/API projection.
8
+
9
+ ## Verification And Inspection
10
+
11
+ | Need | Tool | Boundary |
12
+ | --- | --- | --- |
13
+ | Public proof by URL or ID | `receiz_asset_by_url`, `receiz_asset_by_id` | Resolves through SDK public proof rails; does not claim verification. |
14
+ | Local JSON manifest inspection | `receiz_inspect_offline_file` | Uses SDK shape validators and always reports `verified: false`. |
15
+ | Public asset by URL | `receiz_asset_by_url` | Public proof surface read. |
16
+ | Public asset by ID | `receiz_asset_by_id` | Public proof surface read. |
17
+ | Payload inspection | `receiz_inspect_proof_object` | Structural inspection, not final verifier authority. |
18
+ | Proof query | `receiz_proof_query` | Delegated proof query projection; requires delegated write/read authority in runtime. |
19
+
20
+ ## Sports Proof
21
+
22
+ | Need | Tool | Boundary |
23
+ | --- | --- | --- |
24
+ | Sports card history | `receiz_card_history` | Local-first SDK card memory rail. |
25
+ | Pitch witness | `receiz_pitch_proof_by_witness_id` | Requires already-admitted local pitch day proof truth. |
26
+ | Sports conformance | `receiz_sports_conformance` | Reads conformance status. |
27
+ | Pack preview | `receiz_pack_open_preview` | Preview only; does not append card truth. |
28
+
29
+ ## Settlement And Ownership
30
+
31
+ | Need | Tool | Boundary |
32
+ | --- | --- | --- |
33
+ | Transfer preview | `receiz_transfer_preview` | Deterministic preview; no settlement mutation. |
34
+ | Transfer confirmation policy | `receiz_transfer_requires_confirmation` | Confirmation requirement only. |
35
+ | Wallet ledger | `receiz_wallet_public_ledger` | Settlement projection over ledger truth. |
36
+ | Action ledger | `receiz_action_ledger` | Provenance projection. |
37
+
38
+ ## App And Store Proof Surfaces
39
+
40
+ | Need | Tool |
41
+ | --- | --- |
42
+ | App-state resolve | `receiz_app_state_resolve`, `receiz_app_state_by_url`, `receiz_app_state_by_creator`, `receiz_app_state_by_namespace`, `receiz_app_state_by_id` |
43
+ | Public store resolve | `receiz_public_store_resolve` |
44
+ | Template envelope | `receiz_marketplace_template_generate` |
45
+ | Runtime blueprint | `receiz_runtime_blueprint` |
46
+
47
+ ## Writes
48
+
49
+ `receiz_app_state_publish`, `receiz_public_store_publish`, and `receiz_proof_query` can require delegated runtime authority. Ask for explicit confirmation before any action that appends, publishes, changes settlement, changes ownership, or affects public state.