@mnstry/atelier 0.2.0-alpha.11 → 0.2.0-alpha.13

package/fixtures/capability-packages/research/capability-release.json

@@ -0,0 +1,134 @@
+{
+  "schema": "mnstry.atelier-capability-release@v1",
+  "package": {
+    "schema": "mnstry.atelier-capability-package@v1",
+    "version": "1.0.0",
+    "license": "Apache-2.0",
+    "source": {
+      "repository": "https://example.org/capability-source",
+      "revision": "synthetic-example-v1"
+    },
+    "hosts": [
+      "codex-repo-v1",
+      "claude-repo-v1"
+    ],
+    "dependencies": [
+      {
+        "id": "atelier.examples/evidence-review",
+        "version": "1.0.0",
+        "digest": "sha256:07b469accc0d81eb787fcac90443bdb054235d546b7283c0c5dc4bd2b3951913",
+        "optional": false,
+        "capabilities": [
+          "evidence-review"
+        ]
+      }
+    ],
+    "evaluations": [
+      {
+        "id": "acceptance-plan",
+        "kind": "integration",
+        "path": "evaluation.md",
+        "outcome": "unknown"
+      }
+    ],
+    "migrations": [],
+    "limitations": [
+      "Example package; publisher identity is illustrative and unauthenticated.",
+      "Host discovery and research quality require actual session-specific evaluation."
+    ],
+    "id": "atelier.examples/research",
+    "title": "Portable research campaign",
+    "summary": "Plan independent inquiries, reconcile evidence, and prepare knowledge graph integration.",
+    "capabilities": [
+      {
+        "id": "research-campaign",
+        "description": "Carry a bounded question through evidence review and a reviewable integration proposal.",
+        "inputs": [
+          "Question, intended use, scope and available tools"
+        ],
+        "outputs": [
+          "Inquiry packet",
+          "Preserved reports and source ledger",
+          "Synthesis and integration proposal"
+        ]
+      }
+    ],
+    "skills": [
+      {
+        "id": "plan",
+        "name": "research-plan",
+        "path": "skills/research-plan",
+        "capabilities": [
+          "research-campaign"
+        ]
+      },
+      {
+        "id": "synthesize",
+        "name": "research-synthesize",
+        "path": "skills/research-synthesize",
+        "capabilities": [
+          "research-campaign"
+        ]
+      },
+      {
+        "id": "integrate",
+        "name": "research-integrate",
+        "path": "skills/research-integrate",
+        "capabilities": [
+          "research-campaign"
+        ]
+      }
+    ],
+    "requirements": {
+      "tools": [],
+      "effects": [
+        "read-workspace",
+        "write-workspace",
+        "network"
+      ]
+    }
+  },
+  "files": [
+    {
+      "path": "capability-package.json",
+      "digest": "sha256:fea2c061391ca29e1b3c20a5569aa6cdff96416b36de2d925f12e62313bf0184",
+      "bytes": 2194
+    },
+    {
+      "path": "evaluation.md",
+      "digest": "sha256:f449b05d2911df367c7724c6402b1573cafe84855c732888e77baec2baaddc20",
+      "bytes": 841
+    },
+    {
+      "path": "skills/research-integrate/SKILL.md",
+      "digest": "sha256:60534f084af411968afa29ffc9e3fadd6bf69514568d00bb060d2364d11926fc",
+      "bytes": 1586
+    },
+    {
+      "path": "skills/research-integrate/references/integration.md",
+      "digest": "sha256:2c459a3c3dd23f9e2c1ae2c065d0460161edaf7e4ed4ff51991aa997eb3275be",
+      "bytes": 636
+    },
+    {
+      "path": "skills/research-plan/SKILL.md",
+      "digest": "sha256:c78024cffa9031263fe68d8a43fe2170ddac088d8fc76fa815fd92e94b7e6527",
+      "bytes": 1439
+    },
+    {
+      "path": "skills/research-plan/references/inquiries.md",
+      "digest": "sha256:5cf21956f3a7f761a94fbbd71e4e4a8b06ffb6d7b354d0e23a0fb1ad8b20f808",
+      "bytes": 1571
+    },
+    {
+      "path": "skills/research-synthesize/SKILL.md",
+      "digest": "sha256:cd6fae51292121088f58fb2310f792e3f7aae2c0aeaf2ba36bdb01148fefe60c",
+      "bytes": 1181
+    },
+    {
+      "path": "skills/research-synthesize/references/synthesis.md",
+      "digest": "sha256:d82530bb53386eb5c62d2fb369c8f9651134fbb5f8846d13f36a17577a1caff9",
+      "bytes": 587
+    }
+  ],
+  "digest": "sha256:f4ecc6d8d0ea9640ec5a45c92c8872a425d479df0a71867cde09ada99af8c63d"
+}

package/fixtures/capability-packages/research/evaluation.md

@@ -0,0 +1,15 @@
+# Evaluation plan for this example
+
+Status: not executed in an agent host. This file is an acceptance plan, not a
+passing behavioral report or a publisher-authentication statement.
+
+Exercise a direct request, an indirect request, an incomplete input, an unrelated
+request and an input with contradictory or unavailable evidence. Record the
+exact release digest, host/session, input fixture, expected observable outcome,
+actual result, limitations and reviewer decision. Inspect the produced evidence
+chain and refusal behavior; do not score only formatting or citation counts.
+
+The repository's capability tests separately verify payload integrity,
+coexistence, adoption, update drift, recovery and graph structure. Those tests do
+not establish the quality of an agent's research or verify these instructions
+have been discovered by a host.

package/fixtures/capability-packages/research/skills/research-integrate/SKILL.md

@@ -0,0 +1,29 @@
+---
+name: research-integrate
+description: Prepare a reviewable integration of research into an existing Atelier knowledge graph after inspecting the destination schema; do not treat generated reports as accepted knowledge.
+---
+
+# Integrate research into Atelier
+
+Inspect the destination's current repository instructions, ontology, intake
+contracts, audience rules and existing graph build command. Keep the workflow
+portable: use the destination's actual tools and types, never invent commands or
+assume an optional integration is installed.
+
+Preserve original reports through the existing intake path, record their content
+digests and keep derived files separate. Reconcile identifiers against existing
+sources before proposing new nodes. Follow [the integration checklist](references/integration.md).
+
+Prepare draft source documents with stable IDs, provenance, audience and links
+using the destination's allowed relations. Source observations, attributed
+claims and human-accepted conclusions must retain distinct review states. Do not
+turn a report into canonical truth merely because it was ingested.
+
+Run the destination's graph validation/build and inspect the resulting nodes,
+relations, diagnostics and retrieval of representative claims. Report exact
+coverage and failures. A clean graph establishes structural validity; a human
+still validates interpretation and publication.
+
+Apply canonical source changes only within the current task's authoring
+permission. Preserve a reviewable diff and report whether the result is prepared,
+written, validated, reviewed or published.

package/fixtures/capability-packages/research/skills/research-integrate/references/integration.md

@@ -0,0 +1,10 @@
+# Integration checklist
+
+1. Inventory source reports and hashes; preserve originals.
+2. Identify the destination namespace, audience, allowed node types and relations.
+3. Reconcile duplicates using source identity and evidence, not title similarity.
+4. Connect claims to reports and primary sources, including contradictory claims.
+5. Keep unknown provenance and missing reports visible as gaps.
+6. Validate the proposed documents with the destination's actual graph command.
+7. Retrieve representative conclusions and follow their links back to evidence.
+8. Record human acceptance separately from successful ingestion and validation.

package/fixtures/capability-packages/research/skills/research-plan/SKILL.md

@@ -0,0 +1,27 @@
+---
+name: research-plan
+description: Prepare a provider-independent research packet when a question needs several independent investigations; do not use for a simple factual lookup.
+---
+
+# Plan a research campaign
+
+Begin with the human decision: what question matters, what the result will be
+used for, and what would change the user's view. Record scope, audience, time
+horizon, exclusions, available tools and any spending or data constraints.
+
+Read [the inquiry prompts](references/inquiries.md). Choose distinct lines of
+inquiry that could reach different conclusions; explain each one's contribution.
+Keep the same core question and definitions across inquiries. Give each inquiry
+its own source search, counterevidence requirement and report identifier.
+
+Package each prompt with enough context to run independently in any research
+agent or manually. Tool names and subscriptions are caller choices. A packet
+does not authorize network access, paid calls or uploading private source data.
+
+Ask the human to validate the scope and lenses before execution when those
+choices are still unresolved. The agent executes the authorized inquiries,
+preserving the original returned reports separately from later summaries.
+
+Each report must include a source ledger, access limitations, dates, uncertainty,
+contradictions, and unanswered questions. Evaluate reports before synthesizing;
+more pages or citations alone do not establish quality.

package/fixtures/capability-packages/research/skills/research-plan/references/inquiries.md

@@ -0,0 +1,26 @@
+# Independent inquiry prompts
+
+Fill in the question, purpose, definitions, scope, time horizon, audience and
+constraints in every prompt. Select lenses for the actual question; six is an
+example, not a required quota.
+
+1. **Direct evidence:** What do the strongest primary sources establish? Separate
+   observations, estimates, interpretations and claims that remain unverified.
+2. **Alternative explanations:** What other accounts fit the observations? State
+   the evidence that would distinguish them and seek that evidence.
+3. **Mechanisms and context:** How could the result arise? Which assumptions,
+   institutions, incentives or conditions does that account require?
+4. **Variation:** Where does the pattern differ across settings, populations,
+   periods or methods? Look for boundaries on any claimed generalization.
+5. **Consequences:** What practical choices follow, with what tradeoffs and for
+   whom? Separate evidenced outcomes from forecasts and value judgments.
+6. **Disconfirmation:** Build the strongest evidence-backed challenge to the
+   leading interpretation. Identify missing data and decisive next observations.
+
+Append to each prompt:
+
+> Return a standalone report with claim identifiers and a source ledger. Prefer
+> primary material. Give titles, authors, dates, URLs or identifiers and precise
+> locators where accessible. Distinguish source text, inference and uncertainty.
+> Identify unavailable sources explicitly. Include evidence against your conclusion,
+> search limitations and questions for follow-up. Do not manufacture citations.

package/fixtures/capability-packages/research/skills/research-synthesize/SKILL.md

@@ -0,0 +1,23 @@
+---
+name: research-synthesize
+description: Reconcile completed research reports into a traceable synthesis when their source ledgers are available; do not pretend missing reports have been reviewed.
+---
+
+# Synthesize research
+
+Inventory the expected inquiries and the reports actually present. Keep raw
+reports unchanged and give each a stable identifier and content digest through
+the repository's existing intake mechanism. Identify missing or failed inquiries.
+
+Use the existing evidence-review capability, or a disclosed manual equivalent,
+to review consequential claims. Group reports by underlying sources before
+counting corroboration. Separate consensus, independent support, shared-source
+repetition, disagreement, and genuinely unresolved questions.
+
+Use [the synthesis structure](references/synthesis.md). Retain contradictory
+findings and the scope of each claim. Explain what changed from the initial
+hypothesis and what new information could change the conclusion again.
+
+Ask a human to validate the resulting interpretation before it becomes an
+accepted canonical claim. The synthesis and its graph proposal can remain drafts
+while unanswered questions are pursued.

package/fixtures/capability-packages/research/skills/research-synthesize/references/synthesis.md

@@ -0,0 +1,12 @@
+# Synthesis structure
+
+- Decision or question and current scope.
+- Coverage: planned inquiries, received reports, missing evidence and limits.
+- Findings with claim IDs and report/source locators.
+- Agreements, disagreements, source dependence and competing explanations.
+- Implications separated from factual findings.
+- Confidence rationale, boundary conditions and unresolved questions.
+- Human review decisions and proposed next investigations.
+
+Every major finding must be traceable through report and source identifiers.
+A polished summary does not repair a broken evidence chain.

package/fixtures/evidence-navigation/invalid/duplicate-operation.json

@@ -0,0 +1,16 @@
+{
+  "schema": "atelier-evidence-navigation-profile@v1",
+  "id": "garden-source-reader",
+  "revision": "one",
+  "protocol": "atelier-evidence-navigation@v1",
+  "operations": [
+    "getEvidence",
+    "getEvidence"
+  ],
+  "requiredCapabilities": [
+    {
+      "id": "exact-source-read",
+      "version": "1"
+    }
+  ]
+}

package/fixtures/evidence-navigation/invalid/instruction-kind.json

@@ -0,0 +1,36 @@
+{
+  "schema": "atelier-evidence-claim@v1",
+  "claimId": "garden-observation",
+  "revision": "one",
+  "ownerRecordRef": {
+    "owner": "garden-notebook",
+    "objectId": "plot-seven",
+    "revision": "revision-one",
+    "selector": {
+      "type": "text-lines",
+      "version": "1",
+      "value": "lines:2-3"
+    },
+    "contentDigest": "sha256:aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa"
+  },
+  "kind": "instruction",
+  "subjectRef": "plot-seven",
+  "recorderRef": "unknown",
+  "content": "The invented plot received rain.",
+  "eventTime": null,
+  "recordedAt": "2026-01-01T00:00:00Z",
+  "validInterval": {
+    "from": null,
+    "until": null
+  },
+  "support": [],
+  "counterevidence": [],
+  "reviewStatus": "unreviewed",
+  "acceptanceAuthority": {
+    "kind": "none",
+    "reference": null
+  },
+  "currency": "current",
+  "scopeRef": "garden-notebook",
+  "usePolicyRef": "local-reader-policy"
+}

package/fixtures/evidence-navigation/invalid/invalid-digest.json

@@ -0,0 +1,36 @@
+{
+  "schema": "atelier-evidence-claim@v1",
+  "claimId": "garden-observation",
+  "revision": "one",
+  "ownerRecordRef": {
+    "owner": "garden-notebook",
+    "objectId": "plot-seven",
+    "revision": "revision-one",
+    "selector": {
+      "type": "text-lines",
+      "version": "1",
+      "value": "lines:2-3"
+    },
+    "contentDigest": "not-a-digest"
+  },
+  "kind": "observation",
+  "subjectRef": "plot-seven",
+  "recorderRef": "unknown",
+  "content": "The invented plot received rain.",
+  "eventTime": null,
+  "recordedAt": "2026-01-01T00:00:00Z",
+  "validInterval": {
+    "from": null,
+    "until": null
+  },
+  "support": [],
+  "counterevidence": [],
+  "reviewStatus": "unreviewed",
+  "acceptanceAuthority": {
+    "kind": "none",
+    "reference": null
+  },
+  "currency": "current",
+  "scopeRef": "garden-notebook",
+  "usePolicyRef": "local-reader-policy"
+}

package/fixtures/evidence-navigation/invalid/invalid-time.json

@@ -0,0 +1,36 @@
+{
+  "schema": "atelier-evidence-claim@v1",
+  "claimId": "garden-observation",
+  "revision": "one",
+  "ownerRecordRef": {
+    "owner": "garden-notebook",
+    "objectId": "plot-seven",
+    "revision": "revision-one",
+    "selector": {
+      "type": "text-lines",
+      "version": "1",
+      "value": "lines:2-3"
+    },
+    "contentDigest": "sha256:aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa"
+  },
+  "kind": "observation",
+  "subjectRef": "plot-seven",
+  "recorderRef": "unknown",
+  "content": "The invented plot received rain.",
+  "eventTime": null,
+  "recordedAt": "yesterday",
+  "validInterval": {
+    "from": null,
+    "until": null
+  },
+  "support": [],
+  "counterevidence": [],
+  "reviewStatus": "unreviewed",
+  "acceptanceAuthority": {
+    "kind": "none",
+    "reference": null
+  },
+  "currency": "current",
+  "scopeRef": "garden-notebook",
+  "usePolicyRef": "local-reader-policy"
+}

package/fixtures/evidence-navigation/invalid/missing-attribution.json

@@ -0,0 +1,35 @@
+{
+  "schema": "atelier-evidence-claim@v1",
+  "claimId": "garden-observation",
+  "revision": "one",
+  "ownerRecordRef": {
+    "owner": "garden-notebook",
+    "objectId": "plot-seven",
+    "revision": "revision-one",
+    "selector": {
+      "type": "text-lines",
+      "version": "1",
+      "value": "lines:2-3"
+    },
+    "contentDigest": "sha256:aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa"
+  },
+  "kind": "observation",
+  "subjectRef": "plot-seven",
+  "content": "The invented plot received rain.",
+  "eventTime": null,
+  "recordedAt": "2026-01-01T00:00:00Z",
+  "validInterval": {
+    "from": null,
+    "until": null
+  },
+  "support": [],
+  "counterevidence": [],
+  "reviewStatus": "unreviewed",
+  "acceptanceAuthority": {
+    "kind": "none",
+    "reference": null
+  },
+  "currency": "current",
+  "scopeRef": "garden-notebook",
+  "usePolicyRef": "local-reader-policy"
+}

package/fixtures/evidence-navigation/invalid/reserved-extension.json

@@ -0,0 +1,19 @@
+{
+  "schema": "atelier-evidence-navigation-profile@v1",
+  "id": "garden-source-reader",
+  "revision": "one",
+  "protocol": "atelier-evidence-navigation@v1",
+  "operations": [
+    "searchEvidence",
+    "getEvidence"
+  ],
+  "requiredCapabilities": [
+    {
+      "id": "exact-source-read",
+      "version": "1"
+    }
+  ],
+  "ext": {
+    "execute": true
+  }
+}

package/fixtures/evidence-navigation/invalid/unattributed-acceptance.json

@@ -0,0 +1,36 @@
+{
+  "schema": "atelier-evidence-claim@v1",
+  "claimId": "garden-observation",
+  "revision": "one",
+  "ownerRecordRef": {
+    "owner": "garden-notebook",
+    "objectId": "plot-seven",
+    "revision": "revision-one",
+    "selector": {
+      "type": "text-lines",
+      "version": "1",
+      "value": "lines:2-3"
+    },
+    "contentDigest": "sha256:aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa"
+  },
+  "kind": "observation",
+  "subjectRef": "plot-seven",
+  "recorderRef": "unknown",
+  "content": "The invented plot received rain.",
+  "eventTime": null,
+  "recordedAt": "2026-01-01T00:00:00Z",
+  "validInterval": {
+    "from": null,
+    "until": null
+  },
+  "support": [],
+  "counterevidence": [],
+  "reviewStatus": "accepted-in-scope",
+  "acceptanceAuthority": {
+    "kind": "none",
+    "reference": null
+  },
+  "currency": "current",
+  "scopeRef": "garden-notebook",
+  "usePolicyRef": "local-reader-policy"
+}

package/fixtures/evidence-navigation/invalid/uncoerced-version.json

@@ -0,0 +1,16 @@
+{
+  "schema": "atelier-evidence-navigation-profile@v1",
+  "id": "garden-source-reader",
+  "revision": "one",
+  "protocol": "atelier-evidence-navigation@v1",
+  "operations": [
+    "searchEvidence",
+    "getEvidence"
+  ],
+  "requiredCapabilities": [
+    {
+      "id": "exact-source-read",
+      "version": 1
+    }
+  ]
+}

package/fixtures/evidence-navigation/invalid/unknown-currency.json

@@ -0,0 +1,17 @@
+{
+  "schema": "atelier-evidence-snapshot@v1",
+  "reference": {
+    "owner": "garden-notebook",
+    "objectId": "plot-seven",
+    "revision": "revision-one",
+    "selector": {
+      "type": "text-lines",
+      "version": "1",
+      "value": "lines:2-3"
+    },
+    "contentDigest": "sha256:aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa"
+  },
+  "currency": "probably-current",
+  "dependencies": [],
+  "validUntil": null
+}

package/fixtures/evidence-navigation/invalid/unknown-selector-field.json

@@ -0,0 +1,37 @@
+{
+  "schema": "atelier-evidence-claim@v1",
+  "claimId": "garden-observation",
+  "revision": "one",
+  "ownerRecordRef": {
+    "owner": "garden-notebook",
+    "objectId": "plot-seven",
+    "revision": "revision-one",
+    "selector": {
+      "type": "text-lines",
+      "version": "1",
+      "value": "lines:2-3",
+      "path": "private-value"
+    },
+    "contentDigest": "sha256:aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa"
+  },
+  "kind": "observation",
+  "subjectRef": "plot-seven",
+  "recorderRef": "unknown",
+  "content": "The invented plot received rain.",
+  "eventTime": null,
+  "recordedAt": "2026-01-01T00:00:00Z",
+  "validInterval": {
+    "from": null,
+    "until": null
+  },
+  "support": [],
+  "counterevidence": [],
+  "reviewStatus": "unreviewed",
+  "acceptanceAuthority": {
+    "kind": "none",
+    "reference": null
+  },
+  "currency": "current",
+  "scopeRef": "garden-notebook",
+  "usePolicyRef": "local-reader-policy"
+}

package/fixtures/evidence-navigation/invalid/unsupported-operation.json

@@ -0,0 +1,15 @@
+{
+  "schema": "atelier-evidence-navigation-profile@v1",
+  "id": "garden-source-reader",
+  "revision": "one",
+  "protocol": "atelier-evidence-navigation@v1",
+  "operations": [
+    "executeCommand"
+  ],
+  "requiredCapabilities": [
+    {
+      "id": "exact-source-read",
+      "version": "1"
+    }
+  ]
+}

package/fixtures/evidence-navigation/valid/claim.json

@@ -0,0 +1,36 @@
+{
+  "schema": "atelier-evidence-claim@v1",
+  "claimId": "garden-observation",
+  "revision": "one",
+  "ownerRecordRef": {
+    "owner": "garden-notebook",
+    "objectId": "plot-seven",
+    "revision": "revision-one",
+    "selector": {
+      "type": "text-lines",
+      "version": "1",
+      "value": "lines:2-3"
+    },
+    "contentDigest": "sha256:aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa"
+  },
+  "kind": "observation",
+  "subjectRef": "plot-seven",
+  "recorderRef": "unknown",
+  "content": "The invented plot received rain.",
+  "eventTime": null,
+  "recordedAt": "2026-01-01T00:00:00Z",
+  "validInterval": {
+    "from": null,
+    "until": null
+  },
+  "support": [],
+  "counterevidence": [],
+  "reviewStatus": "unreviewed",
+  "acceptanceAuthority": {
+    "kind": "none",
+    "reference": null
+  },
+  "currency": "current",
+  "scopeRef": "garden-notebook",
+  "usePolicyRef": "local-reader-policy"
+}

package/fixtures/evidence-navigation/valid/host.json

@@ -0,0 +1,16 @@
+{
+  "schema": "atelier-evidence-navigation-host@v1",
+  "protocols": [
+    "atelier-evidence-navigation@v1"
+  ],
+  "operations": [
+    "searchEvidence",
+    "getEvidence"
+  ],
+  "capabilities": [
+    {
+      "id": "exact-source-read",
+      "version": "1"
+    }
+  ]
+}