Forge Intelligence

Handbook

LCDL overlay: Consumer Decisions, Contracts, and Claims Intelligence

Design and test-contract bundle; no runtime implementation or operational certification is claimed. The manifest, schemas, validators, test suite, and task identities are complete enough for repository-native…

Updated

Runtime boundary

Design and test-contract bundle; no runtime implementation or operational certification is claimed. The manifest, schemas, validators, test suite, and task identities are complete enough for repository-native implementation; no placeholder task code is included.

Capability contracts

Capability ID Candidate task ID Required output artifacts Release validators
capability.life.consumer-contracts-claims.define_requirements intelligence_consumer_contracts_claims_define_requirements_v1 artifact.life.consumer-contracts-claims.requirements_brief validator.life.consumer-contracts-claims.01_prices_availability_terms_recalls_and_seller_status, validator.life.consumer-contracts-claims.02_total_cost_financing_fees_and_unit_comparison, validator.life.consumer-contracts-claims.03_legal_advice_boundary_and_prohibited_goods
capability.life.consumer-contracts-claims.research_options intelligence_consumer_contracts_claims_research_options_v1 artifact.life.consumer-contracts-claims.options_and_evidence_ledger validator.life.consumer-contracts-claims.01_prices_availability_terms_recalls_and_seller_status, validator.life.consumer-contracts-claims.02_total_cost_financing_fees_and_unit_comparison, validator.life.consumer-contracts-claims.03_legal_advice_boundary_and_prohibited_goods
capability.life.consumer-contracts-claims.compare_total_value intelligence_consumer_contracts_claims_compare_total_value_v1 artifact.life.consumer-contracts-claims.total_cost_comparison validator.life.consumer-contracts-claims.02_total_cost_financing_fees_and_unit_comparison
capability.life.consumer-contracts-claims.review_contract_terms intelligence_consumer_contracts_claims_review_contract_terms_v1 artifact.life.consumer-contracts-claims.contract_issue_list validator.life.consumer-contracts-claims.01_prices_availability_terms_recalls_and_seller_status, validator.life.consumer-contracts-claims.02_total_cost_financing_fees_and_unit_comparison, validator.life.consumer-contracts-claims.03_legal_advice_boundary_and_prohibited_goods
capability.life.consumer-contracts-claims.check_seller_scam_risk intelligence_consumer_contracts_claims_check_seller_scam_risk_v1 artifact.life.consumer-contracts-claims.scam_risk_review validator.life.consumer-contracts-claims.01_prices_availability_terms_recalls_and_seller_status, validator.life.consumer-contracts-claims.02_total_cost_financing_fees_and_unit_comparison, validator.life.consumer-contracts-claims.03_legal_advice_boundary_and_prohibited_goods
capability.life.consumer-contracts-claims.plan_return_warranty_claim intelligence_consumer_contracts_claims_plan_return_warranty_claim_v1 artifact.life.consumer-contracts-claims.return_or_warranty_plan validator.life.consumer-contracts-claims.04_claim_dossier_dates_documents_and_requested_remedy, validator.life.consumer-contracts-claims.01_prices_availability_terms_recalls_and_seller_status, validator.life.consumer-contracts-claims.02_total_cost_financing_fees_and_unit_comparison
capability.life.consumer-contracts-claims.prepare_complaint intelligence_consumer_contracts_claims_prepare_complaint_v1 artifact.life.consumer-contracts-claims.complaint_and_claim_dossier validator.life.consumer-contracts-claims.03_legal_advice_boundary_and_prohibited_goods, validator.life.consumer-contracts-claims.04_claim_dossier_dates_documents_and_requested_remedy, validator.life.consumer-contracts-claims.01_prices_availability_terms_recalls_and_seller_status

Each capability contract in the manifest defines inputs, outputs, preconditions, postconditions, method-selection rules, invariant references, failure states, risk gate, metrics, and the existing forge-lcdl tasks/operators to compose.

Artifact schemas

Artifact type Schema reference Required payload fields Sensitivity
artifact.life.consumer-contracts-claims.requirements_brief ../schemas/artifacts/consumer-contracts-claims.schema.json#/$defs/requirements_brief requirement_ids, requirement_statements, acceptance_criteria, verification_method, owner, status, traceability_refs restricted
artifact.life.consumer-contracts-claims.options_and_evidence_ledger ../schemas/artifacts/consumer-contracts-claims.schema.json#/$defs/options_and_evidence_ledger entries, entry_ids, owners, status, source_refs, updated_at restricted
artifact.life.consumer-contracts-claims.total_cost_comparison ../schemas/artifacts/consumer-contracts-claims.schema.json#/$defs/total_cost_comparison alternatives, hard_constraints, criteria, normalized_values, evidence_refs, uncertainty, dominance_or_tradeoffs, recommendation_status restricted
artifact.life.consumer-contracts-claims.contract_issue_list ../schemas/artifacts/consumer-contracts-claims.schema.json#/$defs/contract_issue_list entries, entry_ids, owners, status, source_refs, updated_at restricted
artifact.life.consumer-contracts-claims.scam_risk_review ../schemas/artifacts/consumer-contracts-claims.schema.json#/$defs/scam_risk_review question_or_standard, criteria, evidence, findings, uncertainty, limitations, status, recommended_actions restricted
artifact.life.consumer-contracts-claims.return_or_warranty_plan ../schemas/artifacts/consumer-contracts-claims.schema.json#/$defs/return_or_warranty_plan objective, scope, steps, dependencies, constraints, owners, timing, contingencies, review_triggers restricted
artifact.life.consumer-contracts-claims.complaint_and_claim_dossier ../schemas/artifacts/consumer-contracts-claims.schema.json#/$defs/complaint_and_claim_dossier package_id, purpose, contents, document_versions, evidence_index, completeness_status, recipient_or_reviewer, approvals restricted

Validators

Validator ID Kind Automation Severity Failure action
validator.life.consumer-contracts-claims.01_prices_availability_terms_recalls_and_seller_status live_provenance hybrid blocker escalate
validator.life.consumer-contracts-claims.02_total_cost_financing_fees_and_unit_comparison deterministic deterministic blocker escalate
validator.life.consumer-contracts-claims.03_legal_advice_boundary_and_prohibited_goods policy hybrid major repair
validator.life.consumer-contracts-claims.04_claim_dossier_dates_documents_and_requested_remedy evidence_check hybrid minor conditional_pass

Validator checks return itemized evidence and support pass, conditional_pass, fail, inconclusive, or a governed repair/escalation path. Generation does not self-certify.

Existing execution substrate

Tasks to reuse: contradiction_scan, decompose_problem, extract_schema_from_text, formula_eval_safe, llm_boolean_gate, llm_enum_route, plan_decision_pack, word_problem_to_calc_plan
Operators to reuse: branch, fallback_chain, for_each, optional_step, seq, try_catch, until_ok

Cross-intelligence handoff

  • artifact_id, type, version, producer capability, provenance, scope, assumptions, uncertainty, sensitivity, validation status, and next action
  • No free-text handoff may replace a required typed artifact when a downstream validator depends on structure.

Information-loss checks: - all hard constraints preserved - all blocker findings preserved - source scope and date preserved - assumptions and dissent preserved - units, time zones, identifiers, and uncertainty preserved

Evaluation and release

Suite: ../evaluation_suites/consumer-contracts-claims.yaml

  • 100% schema validity for released artifacts
  • 100% material traceability
  • no unresolved blocker validator
  • no missed critical escalation in the approved benchmark
  • documented conditional-pass limits and human gates

Promotion to implementation maturity I1

  • Create repository-native input and output contracts for every candidate task ID.
  • Implement deterministic portions of validators and declare independent human or model review for semantic portions.
  • Connect a provenance-preserving source resolver and enforce freshness and jurisdiction rules.
  • Pass the per-pack suite and dependency regression suites at release thresholds.
  • Complete security, privacy, accessibility, and domain-owner review appropriate to risk.
  • Publish LMETA/LCDL exact-overlay links and CI parity checks.

Exact-overlay identity

The LMETA and LCDL pages share the concept ID, semantic version, capability IDs, and invariant IDs. tools/validate_pack.py checks this parity.

Paired overlay

Runtime maturity

  • Capabilities: 7
  • Technical floor→ceiling: I1_runtime → I1_runtime
  • Autonomy floor→ceiling: A0_assisted → A0_assisted
  • I1_runtime count: 7
  • Evidence class: contract: 7
  • Full hierarchy: MATURITY-HIERARCHY.md

Evaluation suite status

  • CI status: pass
  • Suite: evaluation_suites/consumer-contracts-claims.yaml
  • Cases defined: 7
  • Capabilities under test: 7