@acidicsoil/portable-capabilities 0.1.4 → 0.1.7

package/dist-release/catalog/roles/structural-pattern-extraction.yaml

@@ -0,0 +1,82 @@
+schemaVersion: '1.0'
+id: structural-pattern-extraction
+purpose: Extract durable structural patterns from exemplars.
+family:
+  id: exemplar-modeling
+  version: 1.0.0
+taxonomy:
+  id: structural-pattern-extraction
+  displayName: Structural Pattern Extraction
+  transformation: Extract durable structural patterns from exemplars.
+  intendedOutput: Pattern catalog
+inputs:
+- name: artifact-set
+  description: Artifacts from which durable structure will be extracted.
+  required: true
+- name: segmentation-rules
+  description: Rules for identifying comparable structural units.
+  required: false
+- name: noise-exclusions
+  description: Known incidental or generated features to ignore.
+  required: false
+precedence:
+- sourceClass: explicit-contract
+  rank: 0
+- sourceClass: observed-artifact
+  rank: 1
+- sourceClass: inference
+  rank: 2
+pipeline:
+- id: ingest.sources
+  version: 1.0.0
+- id: trace.build-evidence-ledger
+  version: 1.0.0
+- id: validation.contract
+  version: 1.0.0
+output:
+  schema: canonical/schemas/structural-pattern-extraction.output.schema.json
+  description: Pattern catalog
+requiredBehavior:
+- 'activation: Use structural-pattern-extraction only when the requested outcome requires this transformation: Extract
+  durable structural patterns from exemplars.'
+- 'sufficiency: Require all role inputs marked required and enough evidence to complete these gates: Each pattern
+  has recurrence evidence, applicability conditions, and at least one falsification or negative-example check.'
+- 'conflict: Apply declared source precedence; when equally authoritative evidence changes the decision, preserve
+  both positions and return the affected output field as unresolved.'
+- 'ambiguity: Isolate ambiguous terms or boundaries, show which stage and output fields they affect, and request
+  clarification rather than selecting an unsupported interpretation.'
+- 'abstention: Abstain from structural-pattern-extraction when required inputs are absent, the decision rule cannot
+  be applied, or evidence cannot satisfy the completion gate.'
+- 'stop: Stop before emitting Pattern catalog unless Each pattern has recurrence evidence, applicability conditions,
+  and at least one falsification or negative-example check.'
+- 'resources: Load the artifact set, segmentation rules, and exclusion catalog; use negative examples to reject
+  over-broad patterns.'
+- 'transformation: Execute the ordered analytical procedure: 1) segment artifacts into comparable units; 2) identify
+  repeated relations and ordering constraints; 3) distinguish durable patterns from coincidental repetition; 4)
+  name each pattern and attach positive and negative examples.'
+- 'output: Populate and validate canonical/schemas/structural-pattern-extraction.output.schema.json with required
+  fields patterns, evidenceMatrix, negativeExamples, applicabilityConditions, openHypotheses; do not replace missing
+  fields with prose.'
+- 'traceability: Link every material output field to source identifiers and the analytical stage or decision that
+  produced it; retain counterevidence for unresolved results.'
+- 'evaluation: Pass only when the output schema validates, the ordered stages are evidenced, the role decision rule
+  was applied, and this completion gate holds: Each pattern has recurrence evidence, applicability conditions, and
+  at least one falsification or negative-example check.'
+forbiddenBehavior:
+- Do not substitute generic analytical behavior for the role-specific structural-pattern-extraction transformation.
+- Do not skip, reorder, or silently collapse the role's declared analytical stages.
+- Do not invent missing evidence, resolve authority conflicts by convenience, or emit a completed result after a
+  stop or abstention condition.
+- Do not copy operation-owned ingestion, ledger, or schema-validation mechanics into the role contract.
+traceability:
+  materialClaimsRequireSources: true
+  ledgerFormat: jsonl
+  artifacts: content-addressed
+evaluation:
+  criteria:
+  - The authoritative transformation and intended output for structural-pattern-extraction are preserved.
+  - 'Required inputs and the decision rule are satisfied: Promote a candidate only when recurrence and structural
+    relevance exceed incidental similarity; otherwise retain it as a hypothesis.'
+  - 'The ordered analytical stages are evidenced and the output completion gate passes: Each pattern has recurrence
+    evidence, applicability conditions, and at least one falsification or negative-example check.'
+  - Conflict, ambiguity, insufficient-evidence, abstention, and stop behavior remain explicit and testable.

package/dist-release/catalog/roles/template-family-generation.yaml

@@ -0,0 +1,83 @@
+schemaVersion: '1.0'
+id: template-family-generation
+purpose: Generate a coherent family of reusable templates.
+family:
+  id: context-template-generation
+  version: 1.0.0
+taxonomy:
+  id: template-family-generation
+  displayName: Template Family Generation
+  transformation: Generate a coherent family of reusable templates.
+  intendedOutput: Template family
+inputs:
+- name: template-requirements
+  description: Requirements shared by the template family.
+  required: true
+- name: variation-model
+  description: Allowed variants and their selection conditions.
+  required: true
+- name: reference-artifacts
+  description: Approved examples or existing templates.
+  required: false
+precedence:
+- sourceClass: explicit-contract
+  rank: 0
+- sourceClass: observed-artifact
+  rank: 1
+- sourceClass: inference
+  rank: 2
+pipeline:
+- id: ingest.sources
+  version: 1.0.0
+- id: trace.build-evidence-ledger
+  version: 1.0.0
+- id: validation.contract
+  version: 1.0.0
+output:
+  schema: canonical/schemas/template-family-generation.output.schema.json
+  description: Template family
+requiredBehavior:
+- 'activation: Use template-family-generation only when the requested outcome requires this transformation: Generate
+  a coherent family of reusable templates.'
+- 'sufficiency: Require all role inputs marked required and enough evidence to complete these gates: All required
+  variants are generated, shared behavior is single-sourced, selection rules are deterministic, and every variant
+  validates.'
+- 'conflict: Apply declared source precedence; when equally authoritative evidence changes the decision, preserve
+  both positions and return the affected output field as unresolved.'
+- 'ambiguity: Isolate ambiguous terms or boundaries, show which stage and output fields they affect, and request
+  clarification rather than selecting an unsupported interpretation.'
+- 'abstention: Abstain from template-family-generation when required inputs are absent, the decision rule cannot
+  be applied, or evidence cannot satisfy the completion gate.'
+- 'stop: Stop before emitting Template family unless All required variants are generated, shared behavior is single-sourced,
+  selection rules are deterministic, and every variant validates.'
+- 'resources: Load family requirements, variation model, approved references, and validation schemas; load each
+  reference only for the feature it evidences.'
+- 'transformation: Execute the ordered analytical procedure: 1) derive the invariant template skeleton; 2) model
+  variation points and compatibility constraints; 3) generate each variant from shared primitives; 4) validate family
+  coherence coverage and non-duplication.'
+- 'output: Populate and validate canonical/schemas/template-family-generation.output.schema.json with required fields
+  sharedTemplate, variants, selectionRules, compatibilityMatrix, validationResults; do not replace missing fields
+  with prose.'
+- 'traceability: Link every material output field to source identifiers and the analytical stage or decision that
+  produced it; retain counterevidence for unresolved results.'
+- 'evaluation: Pass only when the output schema validates, the ordered stages are evidenced, the role decision rule
+  was applied, and this completion gate holds: All required variants are generated, shared behavior is single-sourced,
+  selection rules are deterministic, and every variant validates.'
+forbiddenBehavior:
+- Do not substitute generic analytical behavior for the role-specific template-family-generation transformation.
+- Do not skip, reorder, or silently collapse the role's declared analytical stages.
+- Do not invent missing evidence, resolve authority conflicts by convenience, or emit a completed result after a
+  stop or abstention condition.
+- Do not copy operation-owned ingestion, ledger, or schema-validation mechanics into the role contract.
+traceability:
+  materialClaimsRequireSources: true
+  ledgerFormat: jsonl
+  artifacts: content-addressed
+evaluation:
+  criteria:
+  - The authoritative transformation and intended output for template-family-generation are preserved.
+  - 'Required inputs and the decision rule are satisfied: Keep behavior in the shared primitive when all variants
+    require it; create a variant only when a documented selection condition changes structure or obligations.'
+  - 'The ordered analytical stages are evidenced and the output completion gate passes: All required variants are
+    generated, shared behavior is single-sourced, selection rules are deterministic, and every variant validates.'
+  - Conflict, ambiguity, insufficient-evidence, abstention, and stop behavior remain explicit and testable.

package/dist-release/catalog/runtime-profiles/antigravity.yaml

@@ -0,0 +1,60 @@
+schemaVersion: "1.0"
+id: antigravity
+version: 1.0.0
+nativeRoot: .agents/skills
+supportedPrimitives:
+  - skill
+  - workflow
+  - rule
+unsupportedPrimitives:
+  - command
+  - agent
+  - extension
+  - memory
+capabilities:
+  skill: true
+  command: false
+  agent: false
+  workflow: true
+  rule: true
+  extension: false
+  memory: false
+limitations:
+  - Canonical behavior remains in generated skills and resources.
+limits:
+  maxInitialBytes: 8192
+  maxResourceBytes: 1048576
+permissionModel: read-only-default
+provenance:
+  sources:
+    - docs/prd/product.md
+    - .planning/phases/06.1-runtime-usability-and-behavioral-closure/06.1-COMPATIBILITY-RESEARCH.md
+    - https://antigravity.google/changelog
+  reviewedAt: 2026-08-02
+  reviewBy: 2027-02-02
+  reviewer: portable-capabilities
+fallbacks:
+  command: skill-resource
+  agent: skill-resource
+  extension: skill-resource
+  memory: skill-resource
+compatibility:
+  minimumSupportedVersion: null
+  maximumKnownCompatibleVersion: null
+  maximumKnownCompatibleRange: null
+  testedVersions: []
+  outcome: unavailable
+  unknownVersionBehavior: fail
+  harness:
+    identity: antigravity-authoritative-behavioral-harness
+    availability: unavailable
+    evidence: .planning/phases/06.1-runtime-usability-and-behavioral-closure/06.1-COMPATIBILITY-RESEARCH.md#environment-probe
+  reviewedAt: 2026-07-30
+  expiresAt: 2026-10-28
+  approval:
+    status: approved
+    owner: Portable Capabilities maintainers
+    approvedAt: 2026-07-30
+  latestPublishedVersion: 2.4.3
+  releaseSource: https://antigravity.google/changelog
+  releaseObservedAt: 2026-07-30

package/dist-release/catalog/runtime-profiles/claude-code.yaml

@@ -0,0 +1,65 @@
+schemaVersion: "1.0"
+id: claude-code
+version: 1.0.0
+nativeRoot: .claude/skills
+supportedPrimitives:
+  - skill
+  - command
+  - agent
+unsupportedPrimitives:
+  - workflow
+  - rule
+  - extension
+  - memory
+capabilities:
+  skill: true
+  command: true
+  agent: true
+  workflow: false
+  rule: false
+  extension: false
+  memory: false
+limitations:
+  - Canonical behavior remains in generated skills and resources.
+limits:
+  maxInitialBytes: 8192
+  maxResourceBytes: 1048576
+permissionModel: read-only-default
+provenance:
+  sources:
+    - docs/prd/product.md
+    - .planning/phases/06.1-runtime-usability-and-behavioral-closure/06.1-COMPATIBILITY-RESEARCH.md
+    - https://www.npmjs.com/package/@anthropic-ai/claude-code
+  reviewedAt: 2026-08-02
+  reviewBy: 2027-02-02
+  reviewer: portable-capabilities
+fallbacks:
+  workflow: skill-resource
+  rule: skill-resource
+  extension: skill-resource
+  memory: skill-resource
+compatibility:
+  minimumSupportedVersion: 2.1.220
+  maximumKnownCompatibleVersion: 2.1.220
+  maximumKnownCompatibleRange: ">=2.1.220 <=2.1.220"
+  testedVersions:
+    - version: 2.1.220
+      testedAt: 2026-07-29
+      platform: planning-environment
+      executable: claude
+      evidence: .planning/phases/06.1-runtime-usability-and-behavioral-closure/06.1-COMPATIBILITY-RESEARCH.md#environment-probe
+  outcome: supported
+  unknownVersionBehavior: fail
+  harness:
+    identity: claude-code-generated-package-behavioral-harness
+    availability: available
+    evidence: packages/conformance/src/tracer/runtime-usability-evidence.json
+  reviewedAt: 2026-07-30
+  expiresAt: 2026-10-28
+  approval:
+    status: approved
+    owner: Portable Capabilities maintainers
+    approvedAt: 2026-07-30
+  latestPublishedVersion: 2.1.220
+  releaseSource: https://www.npmjs.com/package/@anthropic-ai/claude-code
+  releaseObservedAt: 2026-07-30

package/dist-release/catalog/runtime-profiles/codex.yaml

@@ -0,0 +1,71 @@
+schemaVersion: "1.0"
+id: codex
+version: 1.0.0
+nativeRoot: .agents/skills
+supportedPrimitives:
+  - skill
+  - agent
+unsupportedPrimitives:
+  - command
+  - workflow
+  - rule
+  - extension
+  - memory
+capabilities:
+  skill: true
+  command: false
+  agent: true
+  workflow: false
+  rule: false
+  extension: false
+  memory: false
+limitations:
+  - Canonical behavior remains in generated skills and resources.
+limits:
+  maxInitialBytes: 8192
+  maxResourceBytes: 1048576
+permissionModel: read-only-default
+provenance:
+  sources:
+    - docs/prd/product.md
+    - .planning/phases/06.1-runtime-usability-and-behavioral-closure/06.1-COMPATIBILITY-RESEARCH.md
+    - https://www.npmjs.com/package/@openai/codex
+  reviewedAt: 2026-08-02
+  reviewBy: 2027-02-02
+  reviewer: portable-capabilities
+fallbacks:
+  command: skill-resource
+  workflow: skill-resource
+  rule: skill-resource
+  extension: skill-resource
+  memory: skill-resource
+compatibility:
+  minimumSupportedVersion: 0.144.4
+  maximumKnownCompatibleVersion: 0.146.0
+  maximumKnownCompatibleRange: ">=0.144.4 <=0.146.0"
+  testedVersions:
+    - version: 0.144.4
+      testedAt: 2026-07-29
+      platform: planning-environment
+      executable: codex
+      evidence: .planning/phases/06.1-runtime-usability-and-behavioral-closure/06.1-COMPATIBILITY-RESEARCH.md#environment-probe
+    - version: 0.146.0
+      testedAt: 2026-07-30
+      platform: isolated-temporary-consumer
+      executable: codex
+      evidence: packages/conformance/src/tracer/runtime-usability-evidence.json
+  outcome: supported
+  unknownVersionBehavior: fail
+  harness:
+    identity: codex-generated-package-behavioral-harness
+    availability: available
+    evidence: packages/conformance/src/tracer/runtime-usability-evidence.json
+  reviewedAt: 2026-07-30
+  expiresAt: 2026-10-28
+  approval:
+    status: approved
+    owner: Portable Capabilities maintainers
+    approvedAt: 2026-07-30
+  latestPublishedVersion: 0.146.0
+  releaseSource: https://www.npmjs.com/package/@openai/codex
+  releaseObservedAt: 2026-07-30

package/dist-release/catalog/runtime-profiles/dcode.yaml

@@ -0,0 +1,67 @@
+schemaVersion: "1.0"
+id: dcode
+version: 1.0.0
+nativeRoot: .dcode/skills
+supportedPrimitives:
+  - skill
+unsupportedPrimitives:
+  - command
+  - agent
+  - workflow
+  - rule
+  - extension
+  - memory
+capabilities:
+  skill: true
+  command: false
+  agent: false
+  workflow: false
+  rule: false
+  extension: false
+  memory: false
+limitations:
+  - Canonical behavior remains in generated skills and resources.
+limits:
+  maxInitialBytes: 8192
+  maxResourceBytes: 1048576
+permissionModel: read-only-default
+provenance:
+  sources:
+    - docs/prd/product.md
+    - .planning/phases/06.1-runtime-usability-and-behavioral-closure/06.1-COMPATIBILITY-RESEARCH.md
+    - https://github.com/langchain-ai/deepagents/releases
+  reviewedAt: 2026-08-02
+  reviewBy: 2027-02-02
+  reviewer: portable-capabilities
+fallbacks:
+  command: skill-resource
+  agent: skill-resource
+  workflow: skill-resource
+  rule: skill-resource
+  extension: skill-resource
+  memory: skill-resource
+compatibility:
+  minimumSupportedVersion: 0.1.38
+  maximumKnownCompatibleVersion: 0.1.38
+  maximumKnownCompatibleRange: ">=0.1.38 <=0.1.38"
+  testedVersions:
+    - version: 0.1.38
+      testedAt: 2026-07-29
+      platform: planning-environment
+      executable: dcode
+      evidence: .planning/phases/06.1-runtime-usability-and-behavioral-closure/06.1-COMPATIBILITY-RESEARCH.md#environment-probe
+  outcome: unavailable
+  unknownVersionBehavior: fail
+  harness:
+    identity: dcode-authoritative-behavioral-harness
+    availability: unavailable
+    evidence: .planning/phases/06.1-runtime-usability-and-behavioral-closure/06.1-COMPATIBILITY-RESEARCH.md#projection-and-harness-implications
+  reviewedAt: 2026-07-30
+  expiresAt: 2026-10-28
+  approval:
+    status: approved
+    owner: Portable Capabilities maintainers
+    approvedAt: 2026-07-30
+  latestPublishedVersion: 0.1.50
+  releaseSource: https://github.com/langchain-ai/deepagents/releases
+  releaseObservedAt: 2026-07-30

package/dist-release/catalog/runtime-profiles/oh-my-pi.yaml

@@ -0,0 +1,62 @@
+schemaVersion: "1.0"
+id: oh-my-pi
+version: 1.0.0
+nativeRoot: .pi/skills
+supportedPrimitives:
+  - skill
+unsupportedPrimitives:
+  - command
+  - agent
+  - workflow
+  - rule
+  - extension
+  - memory
+capabilities:
+  skill: true
+  command: false
+  agent: false
+  workflow: false
+  rule: false
+  extension: false
+  memory: false
+limitations:
+  - Canonical behavior remains in generated skills and resources.
+limits:
+  maxInitialBytes: 8192
+  maxResourceBytes: 1048576
+permissionModel: read-only-default
+provenance:
+  sources:
+    - docs/prd/product.md
+    - .planning/phases/06.1-runtime-usability-and-behavioral-closure/06.1-COMPATIBILITY-RESEARCH.md
+    - https://github.com/can1357/oh-my-pi/releases/latest
+  reviewedAt: 2026-08-02
+  reviewBy: 2027-02-02
+  reviewer: portable-capabilities
+fallbacks:
+  command: skill-resource
+  agent: skill-resource
+  workflow: skill-resource
+  rule: skill-resource
+  extension: skill-resource
+  memory: skill-resource
+compatibility:
+  minimumSupportedVersion: null
+  maximumKnownCompatibleVersion: null
+  maximumKnownCompatibleRange: null
+  testedVersions: []
+  outcome: unavailable
+  unknownVersionBehavior: fail
+  harness:
+    identity: oh-my-pi-authoritative-behavioral-harness
+    availability: unavailable
+    evidence: .planning/phases/06.1-runtime-usability-and-behavioral-closure/06.1-COMPATIBILITY-RESEARCH.md#environment-probe
+  reviewedAt: 2026-07-30
+  expiresAt: 2026-10-28
+  approval:
+    status: approved
+    owner: Portable Capabilities maintainers
+    approvedAt: 2026-07-30
+  latestPublishedVersion: 17.2.1
+  releaseSource: https://github.com/can1357/oh-my-pi/releases/latest
+  releaseObservedAt: 2026-07-30

package/dist-release/catalog/runtime-profiles/opencode.yaml

@@ -0,0 +1,65 @@
+schemaVersion: "1.0"
+id: opencode
+version: 1.0.0
+nativeRoot: .opencode/skills
+supportedPrimitives:
+  - skill
+  - command
+  - agent
+unsupportedPrimitives:
+  - workflow
+  - rule
+  - extension
+  - memory
+capabilities:
+  skill: true
+  command: true
+  agent: true
+  workflow: false
+  rule: false
+  extension: false
+  memory: false
+limitations:
+  - Canonical behavior remains in generated skills and resources.
+limits:
+  maxInitialBytes: 8192
+  maxResourceBytes: 1048576
+permissionModel: read-only-default
+provenance:
+  sources:
+    - docs/prd/product.md
+    - .planning/phases/06.1-runtime-usability-and-behavioral-closure/06.1-COMPATIBILITY-RESEARCH.md
+    - https://github.com/anomalyco/opencode/releases/latest
+  reviewedAt: 2026-08-02
+  reviewBy: 2027-02-02
+  reviewer: portable-capabilities
+fallbacks:
+  workflow: skill-resource
+  rule: skill-resource
+  extension: skill-resource
+  memory: skill-resource
+compatibility:
+  minimumSupportedVersion: 1.17.20
+  maximumKnownCompatibleVersion: 1.17.20
+  maximumKnownCompatibleRange: ">=1.17.20 <=1.17.20"
+  testedVersions:
+    - version: 1.17.20
+      testedAt: 2026-07-29
+      platform: planning-environment
+      executable: opencode
+      evidence: .planning/phases/06.1-runtime-usability-and-behavioral-closure/06.1-COMPATIBILITY-RESEARCH.md#environment-probe
+  outcome: unavailable
+  unknownVersionBehavior: fail
+  harness:
+    identity: opencode-authoritative-behavioral-harness
+    availability: unavailable
+    evidence: .planning/phases/06.1-runtime-usability-and-behavioral-closure/06.1-COMPATIBILITY-RESEARCH.md#projection-and-harness-implications
+  reviewedAt: 2026-07-30
+  expiresAt: 2026-10-28
+  approval:
+    status: approved
+    owner: Portable Capabilities maintainers
+    approvedAt: 2026-07-30
+  latestPublishedVersion: 1.17.20
+  releaseSource: https://github.com/anomalyco/opencode/releases/latest
+  releaseObservedAt: 2026-07-30

package/dist-release/catalog/runtime-profiles/pi.yaml

@@ -0,0 +1,66 @@
+schemaVersion: "1.0"
+id: pi
+version: 1.0.0
+nativeRoot: .pi/skills
+supportedPrimitives:
+  - skill
+  - extension
+unsupportedPrimitives:
+  - command
+  - agent
+  - workflow
+  - rule
+  - memory
+capabilities:
+  skill: true
+  command: false
+  agent: false
+  workflow: false
+  rule: false
+  extension: true
+  memory: false
+limitations:
+  - Canonical behavior remains in generated skills and resources.
+limits:
+  maxInitialBytes: 8192
+  maxResourceBytes: 1048576
+permissionModel: read-only-default
+provenance:
+  sources:
+    - docs/prd/product.md
+    - .planning/phases/06.1-runtime-usability-and-behavioral-closure/06.1-COMPATIBILITY-RESEARCH.md
+    - https://www.npmjs.com/package/@earendil-works/pi-coding-agent
+  reviewedAt: 2026-08-02
+  reviewBy: 2027-02-02
+  reviewer: portable-capabilities
+fallbacks:
+  command: skill-resource
+  agent: skill-resource
+  workflow: skill-resource
+  rule: skill-resource
+  memory: skill-resource
+compatibility:
+  minimumSupportedVersion: 0.64.0
+  maximumKnownCompatibleVersion: 0.64.0
+  maximumKnownCompatibleRange: ">=0.64.0 <=0.64.0"
+  testedVersions:
+    - version: 0.64.0
+      testedAt: 2026-07-29
+      platform: planning-environment
+      executable: pi
+      evidence: .planning/phases/06.1-runtime-usability-and-behavioral-closure/06.1-COMPATIBILITY-RESEARCH.md#environment-probe
+  outcome: unavailable
+  unknownVersionBehavior: fail
+  harness:
+    identity: pi-authoritative-behavioral-harness
+    availability: unavailable
+    evidence: .planning/phases/06.1-runtime-usability-and-behavioral-closure/06.1-COMPATIBILITY-RESEARCH.md#projection-and-harness-implications
+  reviewedAt: 2026-07-30
+  expiresAt: 2026-10-28
+  approval:
+    status: approved
+    owner: Portable Capabilities maintainers
+    approvedAt: 2026-07-30
+  latestPublishedVersion: 0.83.0
+  releaseSource: https://www.npmjs.com/package/@earendil-works/pi-coding-agent
+  releaseObservedAt: 2026-07-30