@receiz/ai-skills 105.0.0 → 107.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 -5
- package/package.json +24 -2
- package/receiz-architecture/SKILL.md +53 -0
- package/receiz-architecture/agents/openai.yaml +4 -0
- package/receiz-architecture/manifest.json +57 -0
- package/receiz-authority-security/SKILL.md +53 -0
- package/receiz-authority-security/agents/openai.yaml +4 -0
- package/receiz-authority-security/manifest.json +58 -0
- package/receiz-bearer-ownership/SKILL.md +65 -0
- package/receiz-bearer-ownership/agents/openai.yaml +4 -0
- package/receiz-bearer-ownership/manifest.json +14 -0
- package/receiz-build-production-system/SKILL.md +93 -0
- package/receiz-build-production-system/agents/openai.yaml +4 -0
- package/receiz-build-production-system/manifest.json +67 -0
- package/receiz-causal-sync/SKILL.md +53 -0
- package/receiz-causal-sync/agents/openai.yaml +4 -0
- package/receiz-causal-sync/manifest.json +58 -0
- package/receiz-command-builder/SKILL.md +53 -0
- package/receiz-command-builder/agents/openai.yaml +4 -0
- package/receiz-command-builder/manifest.json +58 -0
- package/receiz-constitutional-laws/SKILL.md +53 -0
- package/receiz-constitutional-laws/agents/openai.yaml +4 -0
- package/receiz-constitutional-laws/manifest.json +58 -0
- package/receiz-cross-app-state/SKILL.md +69 -0
- package/receiz-cross-app-state/agents/openai.yaml +4 -0
- package/receiz-cross-app-state/manifest.json +14 -0
- package/receiz-deterministic-replay/SKILL.md +53 -0
- package/receiz-deterministic-replay/agents/openai.yaml +4 -0
- package/receiz-deterministic-replay/manifest.json +58 -0
- package/receiz-domain-builder/SKILL.md +53 -0
- package/receiz-domain-builder/agents/openai.yaml +4 -0
- package/receiz-domain-builder/manifest.json +58 -0
- package/receiz-identity-profile/SKILL.md +64 -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 +20 -1
- package/receiz-migrations/SKILL.md +52 -0
- package/receiz-migrations/agents/openai.yaml +4 -0
- package/receiz-migrations/manifest.json +58 -0
- package/receiz-observability/SKILL.md +53 -0
- package/receiz-observability/agents/openai.yaml +4 -0
- package/receiz-observability/manifest.json +58 -0
- package/receiz-offline-command/SKILL.md +72 -0
- package/receiz-offline-command/agents/openai.yaml +4 -0
- package/receiz-offline-command/manifest.json +14 -0
- package/receiz-offline-first/SKILL.md +53 -0
- package/receiz-offline-first/agents/openai.yaml +4 -0
- package/receiz-offline-first/manifest.json +58 -0
- package/receiz-performance/SKILL.md +53 -0
- package/receiz-performance/agents/openai.yaml +4 -0
- package/receiz-performance/manifest.json +58 -0
- package/receiz-portable-artifacts/SKILL.md +53 -0
- package/receiz-portable-artifacts/agents/openai.yaml +4 -0
- package/receiz-portable-artifacts/manifest.json +58 -0
- package/receiz-portable-continuity/SKILL.md +69 -0
- package/receiz-portable-continuity/agents/openai.yaml +4 -0
- package/receiz-portable-continuity/manifest.json +14 -0
- package/receiz-proof-media/SKILL.md +69 -0
- package/receiz-proof-media/agents/openai.yaml +4 -0
- package/receiz-proof-media/manifest.json +14 -0
- package/receiz-proof-skill/resources/sdk-reference.md +18 -1
- package/receiz-receipt-admission/SKILL.md +60 -0
- package/receiz-receipt-admission/agents/openai.yaml +4 -0
- package/receiz-receipt-admission/manifest.json +14 -0
- package/receiz-release/SKILL.md +53 -0
- package/receiz-release/agents/openai.yaml +4 -0
- package/receiz-release/manifest.json +58 -0
- package/receiz-testing/SKILL.md +53 -0
- package/receiz-testing/agents/openai.yaml +4 -0
- package/receiz-testing/manifest.json +59 -0
package/README.md
CHANGED
|
@@ -1,12 +1,17 @@
|
|
|
1
1
|
# Receiz AI Skills
|
|
2
2
|
|
|
3
|
-
`receiz-
|
|
4
|
-
|
|
5
|
-
|
|
3
|
+
`receiz-build-production-system` remains the constitutional orchestration skill for substantial
|
|
4
|
+
Receiz applications. Fourteen focused constitutional skills supply architecture,
|
|
5
|
+
domain, law, command, authority, replay, offline, causal, artifact, migration,
|
|
6
|
+
performance, observability, testing, and release contracts. The earlier nine
|
|
7
|
+
domain skills remain packaged for compatibility. v107 adds seven executable
|
|
8
|
+
operation skills for identity profiles, portable continuity, generic bearer
|
|
9
|
+
ownership, offline commands, proof media, cross-app state, and receipt admission.
|
|
10
|
+
Every current manifest requires SDK/MCP `>=107.0.0 <108.0.0`, ruleset `107.0.0`, and registry digest `4d0caa6172a69c3bf5817c1c35db5630e555b5d6d824091d45a90fb426b86ef6`.
|
|
6
11
|
|
|
7
12
|
This package teaches AI agents how to understand, verify, build with, and operate Receiz from the existing repository surfaces.
|
|
8
13
|
|
|
9
|
-
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
|
|
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.
|
|
10
15
|
|
|
11
16
|
Receiz is a proof-native artifact system. A Receiz object is not a database row. It is a proof-carrying artifact. The artifact's witnessed history is the truth boundary. 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.
|
|
12
17
|
|
|
@@ -20,7 +25,12 @@ Agents may acquire scoped delegated access through the official Receiz Connect/O
|
|
|
20
25
|
|
|
21
26
|
## How Agents Should Use This Package
|
|
22
27
|
|
|
23
|
-
Start with `receiz-
|
|
28
|
+
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 v107 operation skill for SDK/MCP implementation and a constitutional skill for broader system law. The compatibility router `receiz-skill-bundle` and proof/domain skills remain available for earlier workflows.
|
|
29
|
+
|
|
30
|
+
The v107 operation skills are executable contracts. Each binds exact SDK calls,
|
|
31
|
+
MCP plan/execute tools, delegated scopes, proof heads, idempotency, offline and
|
|
32
|
+
conflict behavior, receipt verification, confirmation boundaries, and deterministic
|
|
33
|
+
emulator fixtures. They never grant autonomous mutation authority.
|
|
24
34
|
|
|
25
35
|
Do not invent APIs. Use the SDK and MCP maps inside the skills, then inspect the repo when a requested operation is not listed.
|
|
26
36
|
|
package/package.json
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "@receiz/ai-skills",
|
|
3
|
-
"version": "
|
|
3
|
+
"version": "107.0.0",
|
|
4
4
|
"description": "Authoritative Receiz AI operating skills for proof-native SDK and MCP agents.",
|
|
5
5
|
"type": "module",
|
|
6
6
|
"files": [
|
|
@@ -13,7 +13,29 @@
|
|
|
13
13
|
"receiz-offline-verifier-skill",
|
|
14
14
|
"receiz-proof-skill",
|
|
15
15
|
"receiz-skill-bundle",
|
|
16
|
-
"receiz-sports-card-skill"
|
|
16
|
+
"receiz-sports-card-skill",
|
|
17
|
+
"receiz-architecture",
|
|
18
|
+
"receiz-domain-builder",
|
|
19
|
+
"receiz-constitutional-laws",
|
|
20
|
+
"receiz-command-builder",
|
|
21
|
+
"receiz-authority-security",
|
|
22
|
+
"receiz-deterministic-replay",
|
|
23
|
+
"receiz-offline-first",
|
|
24
|
+
"receiz-causal-sync",
|
|
25
|
+
"receiz-portable-artifacts",
|
|
26
|
+
"receiz-migrations",
|
|
27
|
+
"receiz-performance",
|
|
28
|
+
"receiz-observability",
|
|
29
|
+
"receiz-testing",
|
|
30
|
+
"receiz-release",
|
|
31
|
+
"receiz-build-production-system",
|
|
32
|
+
"receiz-identity-profile",
|
|
33
|
+
"receiz-portable-continuity",
|
|
34
|
+
"receiz-bearer-ownership",
|
|
35
|
+
"receiz-offline-command",
|
|
36
|
+
"receiz-proof-media",
|
|
37
|
+
"receiz-cross-app-state",
|
|
38
|
+
"receiz-receipt-admission"
|
|
17
39
|
],
|
|
18
40
|
"keywords": [
|
|
19
41
|
"receiz",
|
|
@@ -0,0 +1,53 @@
|
|
|
1
|
+
---
|
|
2
|
+
name: receiz-architecture
|
|
3
|
+
description: Use when inspecting or changing Receiz domains, system boundaries, truth hierarchy, state machines, or constitutional architecture.
|
|
4
|
+
---
|
|
5
|
+
|
|
6
|
+
# receiz-architecture
|
|
7
|
+
|
|
8
|
+
Map domains, sources of truth, state machines, dependency direction, and cross-domain authority before design or refactoring. Receiz is a proof-native artifact system; this skill operates beneath sealed proof and verified local history.
|
|
9
|
+
|
|
10
|
+
## Constitutional workflow
|
|
11
|
+
|
|
12
|
+
1. Inspect the repository and installed SDK version.
|
|
13
|
+
2. Load the active signed registry and applicable constitutional laws.
|
|
14
|
+
3. Identify every authority boundary affected by the change.
|
|
15
|
+
4. Write the implementation contract before implementation.
|
|
16
|
+
5. Implement canonical changes only through SDK commands.
|
|
17
|
+
6. Add law, mutation, replay, and compatibility tests.
|
|
18
|
+
7. Run MCP conformance checks.
|
|
19
|
+
8. Require independent verifier evidence.
|
|
20
|
+
9. Refuse completion until the release lock passes.
|
|
21
|
+
|
|
22
|
+
Focused outcome: Map domains, sources of truth, state machines, dependency direction, and cross-domain authority before design or refactoring.
|
|
23
|
+
|
|
24
|
+
## Machine contract
|
|
25
|
+
|
|
26
|
+
Read [manifest.json](manifest.json) before acting. Its package range, ruleset, active registry digest requirement, laws, allowed tools, forbidden operations, evidence, escalation conditions, and autonomous-authority ceiling are executable constraints. Use plan/permit/execute for any admitted command and obtain explicit confirmation for the exact permit digest. The skill and MCP context are never proof authority.
|
|
27
|
+
|
|
28
|
+
## Quick reference
|
|
29
|
+
|
|
30
|
+
| Boundary | Required result |
|
|
31
|
+
|---|---|
|
|
32
|
+
| Stronger truth | Sealed artifact and verified local history remain above SDK, MCP, server, DB, session, and UI projections. |
|
|
33
|
+
| Mutation | Canonical state changes only through an allowed SDK command and atomic receipt-producing admission. |
|
|
34
|
+
| Evidence | MCP output and agent assertions do not count; independent verification and release-lock evidence do. |
|
|
35
|
+
| Escalation | Stop on digest skew, authority bypass, missing capability, ambiguous migration, or absent independent evidence. |
|
|
36
|
+
|
|
37
|
+
## Common mistakes
|
|
38
|
+
|
|
39
|
+
- Treating a larger or newer server snapshot as permission to replace stronger admitted truth.
|
|
40
|
+
- Calling an MCP plan, simulation, hash, model response, or passing UI check verification.
|
|
41
|
+
- Appending an event without a command admission receipt.
|
|
42
|
+
- Marking the task complete while required evidence is missing.
|
|
43
|
+
|
|
44
|
+
## Completion refusal
|
|
45
|
+
|
|
46
|
+
Refuse completion when any manifest input, law, test, conformance result, independent-verifier result, or release-lock result is absent or failing. Never reduce the evidence list, change a test to bless a visible regression, invent authority, or accept “the AI said it is valid” as evidence.
|
|
47
|
+
|
|
48
|
+
## Example
|
|
49
|
+
|
|
50
|
+
Request: Map domains, sources of truth, state machines, dependency direction, and cross-domain authority before design or refactoring.
|
|
51
|
+
|
|
52
|
+
Return a written implementation contract and read-only plan first. Execute only allowed commands after exact confirmation, then report registry digest, laws, authority, tests, independent evidence, release-lock status, and the exact remaining boundary.
|
|
53
|
+
|
|
@@ -0,0 +1,57 @@
|
|
|
1
|
+
{
|
|
2
|
+
"schema": "receiz.ai-skill-contract.v106",
|
|
3
|
+
"name": "receiz-architecture",
|
|
4
|
+
"requires": {
|
|
5
|
+
"sdk": ">=107.0.0 <108.0.0",
|
|
6
|
+
"mcp": ">=107.0.0 <108.0.0",
|
|
7
|
+
"ruleset": "107.0.0",
|
|
8
|
+
"registryDigest": "4d0caa6172a69c3bf5817c1c35db5630e555b5d6d824091d45a90fb426b86ef6"
|
|
9
|
+
},
|
|
10
|
+
"laws": [
|
|
11
|
+
"receiz.truth.stronger-first",
|
|
12
|
+
"receiz.registry.digest-alignment",
|
|
13
|
+
"receiz.command-only-mutation"
|
|
14
|
+
],
|
|
15
|
+
"allowedTools": [
|
|
16
|
+
"receiz_architecture_inspect",
|
|
17
|
+
"receiz_authority_inspect",
|
|
18
|
+
"receiz_history_trace",
|
|
19
|
+
"receiz_bypass_scan"
|
|
20
|
+
],
|
|
21
|
+
"forbiddenOperations": [
|
|
22
|
+
"direct-state-write",
|
|
23
|
+
"history-rewrite",
|
|
24
|
+
"authority-bypass"
|
|
25
|
+
],
|
|
26
|
+
"requiredInputs": [
|
|
27
|
+
"repository-root",
|
|
28
|
+
"installed-sdk-version",
|
|
29
|
+
"active-registry-digest",
|
|
30
|
+
"applicable-laws",
|
|
31
|
+
"authority-boundaries"
|
|
32
|
+
],
|
|
33
|
+
"requiredEvidence": [
|
|
34
|
+
"typecheck",
|
|
35
|
+
"law-coverage",
|
|
36
|
+
"mutation-tests",
|
|
37
|
+
"replay-equivalence",
|
|
38
|
+
"compatibility",
|
|
39
|
+
"mcp-conformance",
|
|
40
|
+
"independent-verifier"
|
|
41
|
+
],
|
|
42
|
+
"completionCriteria": [
|
|
43
|
+
"written-implementation-contract",
|
|
44
|
+
"constitutional-context-digest-match",
|
|
45
|
+
"all-required-evidence-pass",
|
|
46
|
+
"release-lock-pass"
|
|
47
|
+
],
|
|
48
|
+
"escalationConditions": [
|
|
49
|
+
"authority-bypass-detected",
|
|
50
|
+
"registry-digest-mismatch",
|
|
51
|
+
"missing-independent-evidence",
|
|
52
|
+
"missing-capability",
|
|
53
|
+
"ambiguous-migration"
|
|
54
|
+
],
|
|
55
|
+
"maximumAutonomousAuthority": "inspect-plan-scaffold-test"
|
|
56
|
+
}
|
|
57
|
+
|
|
@@ -0,0 +1,53 @@
|
|
|
1
|
+
---
|
|
2
|
+
name: receiz-authority-security
|
|
3
|
+
description: Use when work touches capabilities, identity, PBI, tenancy, ownership, settlement, secrets, delegated access, or authority escalation.
|
|
4
|
+
---
|
|
5
|
+
|
|
6
|
+
# receiz-authority-security
|
|
7
|
+
|
|
8
|
+
Audit actors, tenants, capabilities, proof domains, confused-deputy paths, escalation, and cross-boundary effects. Receiz is a proof-native artifact system; this skill operates beneath sealed proof and verified local history.
|
|
9
|
+
|
|
10
|
+
## Constitutional workflow
|
|
11
|
+
|
|
12
|
+
1. Inspect the repository and installed SDK version.
|
|
13
|
+
2. Load the active signed registry and applicable constitutional laws.
|
|
14
|
+
3. Identify every authority boundary affected by the change.
|
|
15
|
+
4. Write the implementation contract before implementation.
|
|
16
|
+
5. Implement canonical changes only through SDK commands.
|
|
17
|
+
6. Add law, mutation, replay, and compatibility tests.
|
|
18
|
+
7. Run MCP conformance checks.
|
|
19
|
+
8. Require independent verifier evidence.
|
|
20
|
+
9. Refuse completion until the release lock passes.
|
|
21
|
+
|
|
22
|
+
Focused outcome: Audit actors, tenants, capabilities, proof domains, confused-deputy paths, escalation, and cross-boundary effects.
|
|
23
|
+
|
|
24
|
+
## Machine contract
|
|
25
|
+
|
|
26
|
+
Read [manifest.json](manifest.json) before acting. Its package range, ruleset, active registry digest requirement, laws, allowed tools, forbidden operations, evidence, escalation conditions, and autonomous-authority ceiling are executable constraints. Use plan/permit/execute for any admitted command and obtain explicit confirmation for the exact permit digest. The skill and MCP context are never proof authority.
|
|
27
|
+
|
|
28
|
+
## Quick reference
|
|
29
|
+
|
|
30
|
+
| Boundary | Required result |
|
|
31
|
+
|---|---|
|
|
32
|
+
| Stronger truth | Sealed artifact and verified local history remain above SDK, MCP, server, DB, session, and UI projections. |
|
|
33
|
+
| Mutation | Canonical state changes only through an allowed SDK command and atomic receipt-producing admission. |
|
|
34
|
+
| Evidence | MCP output and agent assertions do not count; independent verification and release-lock evidence do. |
|
|
35
|
+
| Escalation | Stop on digest skew, authority bypass, missing capability, ambiguous migration, or absent independent evidence. |
|
|
36
|
+
|
|
37
|
+
## Common mistakes
|
|
38
|
+
|
|
39
|
+
- Treating a larger or newer server snapshot as permission to replace stronger admitted truth.
|
|
40
|
+
- Calling an MCP plan, simulation, hash, model response, or passing UI check verification.
|
|
41
|
+
- Appending an event without a command admission receipt.
|
|
42
|
+
- Marking the task complete while required evidence is missing.
|
|
43
|
+
|
|
44
|
+
## Completion refusal
|
|
45
|
+
|
|
46
|
+
Refuse completion when any manifest input, law, test, conformance result, independent-verifier result, or release-lock result is absent or failing. Never reduce the evidence list, change a test to bless a visible regression, invent authority, or accept “the AI said it is valid” as evidence.
|
|
47
|
+
|
|
48
|
+
## Example
|
|
49
|
+
|
|
50
|
+
Request: Audit actors, tenants, capabilities, proof domains, confused-deputy paths, escalation, and cross-boundary effects.
|
|
51
|
+
|
|
52
|
+
Return a written implementation contract and read-only plan first. Execute only allowed commands after exact confirmation, then report registry digest, laws, authority, tests, independent evidence, release-lock status, and the exact remaining boundary.
|
|
53
|
+
|
|
@@ -0,0 +1,58 @@
|
|
|
1
|
+
{
|
|
2
|
+
"schema": "receiz.ai-skill-contract.v106",
|
|
3
|
+
"name": "receiz-authority-security",
|
|
4
|
+
"requires": {
|
|
5
|
+
"sdk": ">=107.0.0 <108.0.0",
|
|
6
|
+
"mcp": ">=107.0.0 <108.0.0",
|
|
7
|
+
"ruleset": "107.0.0",
|
|
8
|
+
"registryDigest": "4d0caa6172a69c3bf5817c1c35db5630e555b5d6d824091d45a90fb426b86ef6"
|
|
9
|
+
},
|
|
10
|
+
"laws": [
|
|
11
|
+
"receiz.authority.capability-bound",
|
|
12
|
+
"receiz.identity.proof-bound",
|
|
13
|
+
"receiz.truth.stronger-first"
|
|
14
|
+
],
|
|
15
|
+
"allowedTools": [
|
|
16
|
+
"receiz_architecture_inspect",
|
|
17
|
+
"receiz_authority_inspect",
|
|
18
|
+
"receiz_bypass_scan",
|
|
19
|
+
"receiz_command_simulate",
|
|
20
|
+
"receiz_law_explain"
|
|
21
|
+
],
|
|
22
|
+
"forbiddenOperations": [
|
|
23
|
+
"direct-state-write",
|
|
24
|
+
"history-rewrite",
|
|
25
|
+
"authority-bypass"
|
|
26
|
+
],
|
|
27
|
+
"requiredInputs": [
|
|
28
|
+
"repository-root",
|
|
29
|
+
"installed-sdk-version",
|
|
30
|
+
"active-registry-digest",
|
|
31
|
+
"applicable-laws",
|
|
32
|
+
"authority-boundaries"
|
|
33
|
+
],
|
|
34
|
+
"requiredEvidence": [
|
|
35
|
+
"typecheck",
|
|
36
|
+
"law-coverage",
|
|
37
|
+
"mutation-tests",
|
|
38
|
+
"replay-equivalence",
|
|
39
|
+
"compatibility",
|
|
40
|
+
"mcp-conformance",
|
|
41
|
+
"independent-verifier"
|
|
42
|
+
],
|
|
43
|
+
"completionCriteria": [
|
|
44
|
+
"written-implementation-contract",
|
|
45
|
+
"constitutional-context-digest-match",
|
|
46
|
+
"all-required-evidence-pass",
|
|
47
|
+
"release-lock-pass"
|
|
48
|
+
],
|
|
49
|
+
"escalationConditions": [
|
|
50
|
+
"authority-bypass-detected",
|
|
51
|
+
"registry-digest-mismatch",
|
|
52
|
+
"missing-independent-evidence",
|
|
53
|
+
"missing-capability",
|
|
54
|
+
"ambiguous-migration"
|
|
55
|
+
],
|
|
56
|
+
"maximumAutonomousAuthority": "inspect-plan-scaffold-test"
|
|
57
|
+
}
|
|
58
|
+
|
|
@@ -0,0 +1,65 @@
|
|
|
1
|
+
---
|
|
2
|
+
name: receiz-bearer-ownership
|
|
3
|
+
description: Use when claiming ownership of any qualifying Receiz bearer artifact and invalidating its previous active owner projection.
|
|
4
|
+
---
|
|
5
|
+
|
|
6
|
+
# Receiz Bearer Ownership
|
|
7
|
+
|
|
8
|
+
Claim the generic enclosing artifact, not a card-specific or subpayload-specific invention. Verify the stronger proof object before projecting its embedded payload.
|
|
9
|
+
|
|
10
|
+
## Exact SDK operation
|
|
11
|
+
|
|
12
|
+
Use `proofHead.get`, `ownership.claimBearerAsset`, and `receipts.verify` for every supported artifact type.
|
|
13
|
+
|
|
14
|
+
```ts
|
|
15
|
+
import { createReceizClient } from "@receiz/sdk";
|
|
16
|
+
|
|
17
|
+
const receiz = createReceizClient({ accessToken });
|
|
18
|
+
const expectedOwnershipHead = await receiz.proofHead.get({ aggregateId: `ownership:${artifactId}` });
|
|
19
|
+
const result = await receiz.ownership.claimBearerAsset({
|
|
20
|
+
artifactBytes: new Uint8Array(await artifactFile.arrayBuffer()),
|
|
21
|
+
filename: artifactFile.name,
|
|
22
|
+
mimeType: artifactFile.type || "application/octet-stream",
|
|
23
|
+
claimantKeyId,
|
|
24
|
+
expectedOwnershipHead,
|
|
25
|
+
idempotencyKey: `claim:${artifactId}:${claimantKeyId}:${expectedOwnershipHead.digest}`,
|
|
26
|
+
});
|
|
27
|
+
if (!await receiz.receipts.verify(result.receipt)) throw new Error("receipt_invalid");
|
|
28
|
+
if (result.previousOwnerProjection.active || !result.owner.active) throw new Error("custody_conflict");
|
|
29
|
+
```
|
|
30
|
+
|
|
31
|
+
## Required authority
|
|
32
|
+
|
|
33
|
+
Require the claimant Receiz identity plus delegated `receiz:record` and `receiz:seal` scopes or the corresponding signed-in session. The enclosing sealed artifact remains ownership authority.
|
|
34
|
+
|
|
35
|
+
## Required proof head
|
|
36
|
+
|
|
37
|
+
Read `ownership:${artifactId}` immediately before planning. Pass that exact head; never use a subpayload hash as the ownership boundary.
|
|
38
|
+
|
|
39
|
+
## Idempotency
|
|
40
|
+
|
|
41
|
+
Bind the key to artifact identity, claimant identity, artifact bytes, and expected ownership head. Exact replay returns the original admitted artifact; changed input with the same key is a conflict.
|
|
42
|
+
|
|
43
|
+
## Offline behavior
|
|
44
|
+
|
|
45
|
+
Offline work may verify the artifact and queue signed claim intent, but cannot report global ownership. Display `queued`, preserve the original artifact, and admit only after reconnect.
|
|
46
|
+
|
|
47
|
+
## Conflict behavior
|
|
48
|
+
|
|
49
|
+
On `ownership_head_stale` or `custody_conflict`, fetch the canonical ownership head and show the current owner/custody chain. Never overwrite, silently retry against a new owner, or revive the previous active projection.
|
|
50
|
+
|
|
51
|
+
## Receipt verification
|
|
52
|
+
|
|
53
|
+
Verify the returned canonical receipt and confirm `previousOwnerProjection.active === false`, `owner.active === true`, and ownership-head continuity before reporting ownership.
|
|
54
|
+
|
|
55
|
+
## User confirmation
|
|
56
|
+
|
|
57
|
+
Show artifact ID/type, claimant key ID, prior owner, expected head, irreversible custody consequence, and idempotency key. Require explicit confirmation.
|
|
58
|
+
|
|
59
|
+
## MCP parity
|
|
60
|
+
|
|
61
|
+
Call `receiz_proof_head_get`, then `receiz_bearer_asset_claim_plan`. Require the exact digest, call `receiz_bearer_asset_claim_execute`, then call `receiz_receipt_verify`. MCP planning and subpayload hashes are not proof authority.
|
|
62
|
+
|
|
63
|
+
## Emulator fixture
|
|
64
|
+
|
|
65
|
+
Run `generic-bearer-transfer` and `previous-owner-projection-invalidation` across all supported artifact families.
|
|
@@ -0,0 +1,14 @@
|
|
|
1
|
+
{
|
|
2
|
+
"schema": "receiz.ai-skill-contract.v107",
|
|
3
|
+
"name": "receiz-bearer-ownership",
|
|
4
|
+
"version": "107.0.0",
|
|
5
|
+
"requires": { "sdk": ">=107.0.0 <108.0.0", "mcp": ">=107.0.0 <108.0.0", "ruleset": "107.0.0", "registryDigest": "4d0caa6172a69c3bf5817c1c35db5630e555b5d6d824091d45a90fb426b86ef6" },
|
|
6
|
+
"laws": ["receiz.ownership.enclosing-proof", "receiz.custody.single-active-owner", "receiz.receipt.verify"],
|
|
7
|
+
"sdkOperations": ["ownership.claimBearerAsset", "proofHead.get", "receipts.verify"],
|
|
8
|
+
"allowedTools": ["receiz_bearer_asset_claim_plan", "receiz_bearer_asset_claim_execute", "receiz_proof_head_get", "receiz_receipt_verify"],
|
|
9
|
+
"requiredScopes": ["receiz:record", "receiz:seal"],
|
|
10
|
+
"emulatorFixtures": ["generic-bearer-transfer", "previous-owner-projection-invalidation"],
|
|
11
|
+
"forbiddenOperations": ["direct-state-write", "subpayload-authority", "previous-owner-reactivation", "authority-bypass"],
|
|
12
|
+
"requiredEvidence": ["receipt-verification", "emulator-conformance", "release-lock-pass"],
|
|
13
|
+
"maximumAutonomousAuthority": "inspect-plan-simulate"
|
|
14
|
+
}
|
|
@@ -0,0 +1,93 @@
|
|
|
1
|
+
---
|
|
2
|
+
name: receiz-build-production-system
|
|
3
|
+
description: Use when building or materially changing a production Receiz application across multiple constitutional domains.
|
|
4
|
+
---
|
|
5
|
+
|
|
6
|
+
# receiz-build-production-system
|
|
7
|
+
|
|
8
|
+
Coordinate the complete production workflow across architecture, domains, laws, commands, history, offline behavior, MCP, verification, migration, and release. Receiz is a proof-native artifact system; this skill operates beneath sealed proof and verified local history.
|
|
9
|
+
|
|
10
|
+
## Constitutional workflow
|
|
11
|
+
|
|
12
|
+
1. Inspect the repository and installed SDK version.
|
|
13
|
+
2. Load the active signed registry and applicable constitutional laws.
|
|
14
|
+
3. Identify every authority boundary affected by the change.
|
|
15
|
+
4. Write the implementation contract before implementation.
|
|
16
|
+
5. Implement canonical changes only through SDK commands.
|
|
17
|
+
6. Add law, mutation, replay, and compatibility tests.
|
|
18
|
+
7. Run MCP conformance checks.
|
|
19
|
+
8. Require independent verifier evidence.
|
|
20
|
+
9. Refuse completion until the release lock passes.
|
|
21
|
+
|
|
22
|
+
## Orchestration
|
|
23
|
+
|
|
24
|
+
1. Discover
|
|
25
|
+
2. Model domain
|
|
26
|
+
3. Compile laws
|
|
27
|
+
4. Define commands
|
|
28
|
+
5. Implement events
|
|
29
|
+
6. Build projections
|
|
30
|
+
7. Add offline behavior
|
|
31
|
+
8. Expose safe MCP tools
|
|
32
|
+
9. Generate tests
|
|
33
|
+
10. Audit authority
|
|
34
|
+
11. Verify performance
|
|
35
|
+
12. Release-lock
|
|
36
|
+
|
|
37
|
+
**REQUIRED SUB-SKILL:** Use receiz-architecture
|
|
38
|
+
|
|
39
|
+
**REQUIRED SUB-SKILL:** Use receiz-domain-builder
|
|
40
|
+
|
|
41
|
+
**REQUIRED SUB-SKILL:** Use receiz-constitutional-laws
|
|
42
|
+
|
|
43
|
+
**REQUIRED SUB-SKILL:** Use receiz-command-builder
|
|
44
|
+
|
|
45
|
+
**REQUIRED SUB-SKILL:** Use receiz-authority-security
|
|
46
|
+
|
|
47
|
+
**REQUIRED SUB-SKILL:** Use receiz-deterministic-replay
|
|
48
|
+
|
|
49
|
+
**REQUIRED SUB-SKILL:** Use receiz-offline-first
|
|
50
|
+
|
|
51
|
+
**REQUIRED SUB-SKILL:** Use receiz-causal-sync
|
|
52
|
+
|
|
53
|
+
**REQUIRED SUB-SKILL:** Use receiz-portable-artifacts
|
|
54
|
+
|
|
55
|
+
**REQUIRED SUB-SKILL:** Use receiz-migrations
|
|
56
|
+
|
|
57
|
+
**REQUIRED SUB-SKILL:** Use receiz-performance
|
|
58
|
+
|
|
59
|
+
**REQUIRED SUB-SKILL:** Use receiz-observability
|
|
60
|
+
|
|
61
|
+
**REQUIRED SUB-SKILL:** Use receiz-testing
|
|
62
|
+
|
|
63
|
+
**REQUIRED SUB-SKILL:** Use receiz-release
|
|
64
|
+
|
|
65
|
+
## Machine contract
|
|
66
|
+
|
|
67
|
+
Read [manifest.json](manifest.json) before acting. Its package range, ruleset, active registry digest requirement, laws, allowed tools, forbidden operations, evidence, escalation conditions, and autonomous-authority ceiling are executable constraints. Use plan/permit/execute for any admitted command and obtain explicit confirmation for the exact permit digest. The skill and MCP context are never proof authority.
|
|
68
|
+
|
|
69
|
+
## Quick reference
|
|
70
|
+
|
|
71
|
+
| Boundary | Required result |
|
|
72
|
+
|---|---|
|
|
73
|
+
| Stronger truth | Sealed artifact and verified local history remain above SDK, MCP, server, DB, session, and UI projections. |
|
|
74
|
+
| Mutation | Canonical state changes only through an allowed SDK command and atomic receipt-producing admission. |
|
|
75
|
+
| Evidence | MCP output and agent assertions do not count; independent verification and release-lock evidence do. |
|
|
76
|
+
| Escalation | Stop on digest skew, authority bypass, missing capability, ambiguous migration, or absent independent evidence. |
|
|
77
|
+
|
|
78
|
+
## Common mistakes
|
|
79
|
+
|
|
80
|
+
- Treating a larger or newer server snapshot as permission to replace stronger admitted truth.
|
|
81
|
+
- Calling an MCP plan, simulation, hash, model response, or passing UI check verification.
|
|
82
|
+
- Appending an event without a command admission receipt.
|
|
83
|
+
- Marking the task complete while required evidence is missing.
|
|
84
|
+
|
|
85
|
+
## Completion refusal
|
|
86
|
+
|
|
87
|
+
Refuse completion when any manifest input, law, test, conformance result, independent-verifier result, or release-lock result is absent or failing. Never reduce the evidence list, change a test to bless a visible regression, invent authority, or accept “the AI said it is valid” as evidence.
|
|
88
|
+
|
|
89
|
+
## Example
|
|
90
|
+
|
|
91
|
+
Request: Build a production Receiz domain.
|
|
92
|
+
|
|
93
|
+
Return the implementation contract and plan. Execute confirmed allowed commands, then report all evidence and the exact remaining boundary.
|
|
@@ -0,0 +1,67 @@
|
|
|
1
|
+
{
|
|
2
|
+
"schema": "receiz.ai-skill-contract.v106",
|
|
3
|
+
"name": "receiz-build-production-system",
|
|
4
|
+
"requires": {
|
|
5
|
+
"sdk": ">=107.0.0 <108.0.0",
|
|
6
|
+
"mcp": ">=107.0.0 <108.0.0",
|
|
7
|
+
"ruleset": "107.0.0",
|
|
8
|
+
"registryDigest": "4d0caa6172a69c3bf5817c1c35db5630e555b5d6d824091d45a90fb426b86ef6"
|
|
9
|
+
},
|
|
10
|
+
"laws": [
|
|
11
|
+
"receiz.truth.stronger-first",
|
|
12
|
+
"receiz.registry.digest-alignment",
|
|
13
|
+
"receiz.command-only-mutation",
|
|
14
|
+
"receiz.release.locked-digest"
|
|
15
|
+
],
|
|
16
|
+
"allowedTools": [
|
|
17
|
+
"receiz_architecture_inspect",
|
|
18
|
+
"receiz_domain_scaffold",
|
|
19
|
+
"receiz_command_scaffold",
|
|
20
|
+
"receiz_law_define",
|
|
21
|
+
"receiz_law_coverage",
|
|
22
|
+
"receiz_authority_inspect",
|
|
23
|
+
"receiz_command_simulate",
|
|
24
|
+
"receiz_receipt_replay",
|
|
25
|
+
"receiz_history_trace",
|
|
26
|
+
"receiz_merge_simulate",
|
|
27
|
+
"receiz_bypass_scan",
|
|
28
|
+
"receiz_conformance_run",
|
|
29
|
+
"receiz_release_verify"
|
|
30
|
+
],
|
|
31
|
+
"forbiddenOperations": [
|
|
32
|
+
"direct-state-write",
|
|
33
|
+
"history-rewrite",
|
|
34
|
+
"authority-bypass"
|
|
35
|
+
],
|
|
36
|
+
"requiredInputs": [
|
|
37
|
+
"repository-root",
|
|
38
|
+
"installed-sdk-version",
|
|
39
|
+
"active-registry-digest",
|
|
40
|
+
"applicable-laws",
|
|
41
|
+
"authority-boundaries"
|
|
42
|
+
],
|
|
43
|
+
"requiredEvidence": [
|
|
44
|
+
"typecheck",
|
|
45
|
+
"law-coverage",
|
|
46
|
+
"mutation-tests",
|
|
47
|
+
"replay-equivalence",
|
|
48
|
+
"compatibility",
|
|
49
|
+
"mcp-conformance",
|
|
50
|
+
"independent-verifier"
|
|
51
|
+
],
|
|
52
|
+
"completionCriteria": [
|
|
53
|
+
"written-implementation-contract",
|
|
54
|
+
"constitutional-context-digest-match",
|
|
55
|
+
"all-required-evidence-pass",
|
|
56
|
+
"release-lock-pass"
|
|
57
|
+
],
|
|
58
|
+
"escalationConditions": [
|
|
59
|
+
"authority-bypass-detected",
|
|
60
|
+
"registry-digest-mismatch",
|
|
61
|
+
"missing-independent-evidence",
|
|
62
|
+
"missing-capability",
|
|
63
|
+
"ambiguous-migration"
|
|
64
|
+
],
|
|
65
|
+
"maximumAutonomousAuthority": "inspect-plan-scaffold-test"
|
|
66
|
+
}
|
|
67
|
+
|
|
@@ -0,0 +1,53 @@
|
|
|
1
|
+
---
|
|
2
|
+
name: receiz-causal-sync
|
|
3
|
+
description: Use when implementing multi-device synchronization, partitions, causal ordering, conflicts, retries, merge, or regional convergence.
|
|
4
|
+
---
|
|
5
|
+
|
|
6
|
+
# receiz-causal-sync
|
|
7
|
+
|
|
8
|
+
Carry causal parents and Kai ordering, simulate partitions, resolve declared conflicts, and preserve deterministic convergence. Receiz is a proof-native artifact system; this skill operates beneath sealed proof and verified local history.
|
|
9
|
+
|
|
10
|
+
## Constitutional workflow
|
|
11
|
+
|
|
12
|
+
1. Inspect the repository and installed SDK version.
|
|
13
|
+
2. Load the active signed registry and applicable constitutional laws.
|
|
14
|
+
3. Identify every authority boundary affected by the change.
|
|
15
|
+
4. Write the implementation contract before implementation.
|
|
16
|
+
5. Implement canonical changes only through SDK commands.
|
|
17
|
+
6. Add law, mutation, replay, and compatibility tests.
|
|
18
|
+
7. Run MCP conformance checks.
|
|
19
|
+
8. Require independent verifier evidence.
|
|
20
|
+
9. Refuse completion until the release lock passes.
|
|
21
|
+
|
|
22
|
+
Focused outcome: Carry causal parents and Kai ordering, simulate partitions, resolve declared conflicts, and preserve deterministic convergence.
|
|
23
|
+
|
|
24
|
+
## Machine contract
|
|
25
|
+
|
|
26
|
+
Read [manifest.json](manifest.json) before acting. Its package range, ruleset, active registry digest requirement, laws, allowed tools, forbidden operations, evidence, escalation conditions, and autonomous-authority ceiling are executable constraints. Use plan/permit/execute for any admitted command and obtain explicit confirmation for the exact permit digest. The skill and MCP context are never proof authority.
|
|
27
|
+
|
|
28
|
+
## Quick reference
|
|
29
|
+
|
|
30
|
+
| Boundary | Required result |
|
|
31
|
+
|---|---|
|
|
32
|
+
| Stronger truth | Sealed artifact and verified local history remain above SDK, MCP, server, DB, session, and UI projections. |
|
|
33
|
+
| Mutation | Canonical state changes only through an allowed SDK command and atomic receipt-producing admission. |
|
|
34
|
+
| Evidence | MCP output and agent assertions do not count; independent verification and release-lock evidence do. |
|
|
35
|
+
| Escalation | Stop on digest skew, authority bypass, missing capability, ambiguous migration, or absent independent evidence. |
|
|
36
|
+
|
|
37
|
+
## Common mistakes
|
|
38
|
+
|
|
39
|
+
- Treating a larger or newer server snapshot as permission to replace stronger admitted truth.
|
|
40
|
+
- Calling an MCP plan, simulation, hash, model response, or passing UI check verification.
|
|
41
|
+
- Appending an event without a command admission receipt.
|
|
42
|
+
- Marking the task complete while required evidence is missing.
|
|
43
|
+
|
|
44
|
+
## Completion refusal
|
|
45
|
+
|
|
46
|
+
Refuse completion when any manifest input, law, test, conformance result, independent-verifier result, or release-lock result is absent or failing. Never reduce the evidence list, change a test to bless a visible regression, invent authority, or accept “the AI said it is valid” as evidence.
|
|
47
|
+
|
|
48
|
+
## Example
|
|
49
|
+
|
|
50
|
+
Request: Carry causal parents and Kai ordering, simulate partitions, resolve declared conflicts, and preserve deterministic convergence.
|
|
51
|
+
|
|
52
|
+
Return a written implementation contract and read-only plan first. Execute only allowed commands after exact confirmation, then report registry digest, laws, authority, tests, independent evidence, release-lock status, and the exact remaining boundary.
|
|
53
|
+
|