Governed market sensemaking on the shared ACE foundation.
ACE Market Intelligence is an independently versioned ACE domain product. Its installable package is an inert, JSON-only Domain Pack for turning attributable market observations into domain-governed Shifts, Signals, Cases, and Briefs through the shared ACE Core + Intelligence runtime.
It supplies Market vocabulary, source mappings, material-change policy, personas, synthesis and feedback policy, connector fixtures, and product evidence. It does not implement a second reasoning engine, graph, state store, authority system, detector runtime, or feedback loop.
Install · Architecture · Proof · Roadmap · Security · Contributing
- Distribution:
ace-domain-market-intelligence0.6.0 - Requires: Python 3.12 and
ace-core>=0.4.1,<0.5 - Artifact boundary: JSON-only, data-only, inert
- Release: public. The
v0.6.0GitHub Release and0.6.0PyPI distribution are public. GI2 and the external GC1 consumer journey passed. See the 0.6.0 release record.
The unreleased ACE 0.8 candidate also projects Market’s analyst intelligence loop through the
single governed resource plane with an explicit no_action Decision and non-live Feedback. That
proof is additive and does not change the public 0.6.0 installation contract; see the
candidate evidence.
The product is split into three layers, and this repository owns only the third.
| Layer | Distribution | What it is |
|---|---|---|
| ACE Core | ace-core (public on PyPI; this release targets 0.4.1) |
The runtime: identity, graph, immutable records, temporal validation, lineage, reasoning, authority, decisions, outcomes, receipts, and replay. |
| ACE Intelligence | shipped with ACE Core | The domain-neutral contracts: pack compilation, activation, Observation, Entity Snapshot, detection, routing, Case, Brief synthesis, epistemic status, and feedback. |
| Market Intelligence Domain Pack | ace-domain-market-intelligence (this repository) |
JSON declarations only — ontology, source mappings, detection, personas, synthesis, feedback policy, and frozen conformance fixtures. |
Installing the Domain Pack adds data, not behavior. The wheel contains no Python modules, entry points, install hooks, connector, or application UI. ACE Core compiles those JSON modules and does the reasoning. Live sensing requires a separately reviewed connector; see Connector boundary.
Install the public package with either command:
uv add "ace-domain-market-intelligence==0.6.0"pip install "ace-domain-market-intelligence==0.6.0"The published 0.6.0 proof intentionally pins ace-core>=0.4.1,<0.5. World Intelligence 0.9.0
targets Core 0.5.0, so those two exact released domain versions are not co-installable in one
environment. That is independent release cadence, not an architectural split; Market's Core 0.5
compatibility must be proven and released rather than asserted by widening metadata.
Resolve the pack data from the installed distribution:
import json
from importlib.resources import files
manifest = json.loads(
files("domain_packs.market_intelligence").joinpath("manifest.json").read_text(encoding="utf-8")
)
print(manifest["metadata"]["pack_id"]) # market_intelligenceauthorized evidence → Observation → Entity Snapshot
├────────→ Signal ──┐
└────────→ Shift ───┼→ Case / Brief → Decision → Outcome
└→ governed feedback proposal
This is a typed DAG, not a forced pipeline. A Shift need not become a Signal, a Signal need not become a Brief, and no downstream resource grants itself authority.
The full Market Intelligence domain is intended to cover:
- competitive intelligence;
- product and pricing intelligence;
- market and megatrend understanding;
- customer and voice-of-customer understanding;
- narrative, claim, and messaging drift;
- campaign and go-to-market signals; and
- competitive, event, weekly-summary, GTM, and de-positioning Brief policies.
These are Market-domain types and taxonomies. The shared machinery remains in ACE.
The current frozen proof is deliberately narrower: its compiled 0.3.0 pack models competitor and product entities, public price observations, numeric price Shifts, competitive Signals, persona routing, and a governed competitive-price Brief. Additive 0.4.0 and 0.5.0 pack revisions add ordered synthesis and bounded decision/outcome policy; the 0.6.0 distribution adds the P1F LIVE-bridge conformance packet without pretending that every planned Market facet is implemented.
The repository carries the frozen Market P1 packets:
- P1A/P1B: deterministic price observations, numeric Shift, Signal routing, and Brief resources;
- P1C1/P1C2: declarative source mapping and governed LIVE source admission;
- P1D1: governed Case-bound Brief synthesis and exact replay;
- P1E: Decision, Outcome, and bounded feedback proposal with no silent policy change; and
- P1F: the paired LIVE Shift → Signal → route → Brief bridge through unchanged ACE.
The separately packaged public-product connector accepts only an injected reviewed transport. It is
executable host software, not Domain Pack content. It is source-available here for conformance but
is not a dependency of the Domain Pack and was not published by the 0.6.0 root release. Installing
ace-domain-market-intelligence never installs, discovers, registers, or authorizes it.
The public release proved a clean installation of ACE plus both independently packaged domains:
ace-core 0.4.1
+ ace-domain-market-intelligence 0.6.0
+ ace-domain-world-intelligence 0.8.0
Both packs compiled and activated through unchanged ACE, retained distinct pack, entity, persona, policy, and authority identities, and survived independent deactivation. A co-install alone was not enough. This supplied the second public-domain evidence that closed Core roadmap outcome GI2.
Publication identities and verification are recorded in the 0.6.0 release record. This is an exact historical receipt; World has since released 0.9.0 against Core 0.5.0.
Market Intelligence is the first external consumer of ACE's public governed-cognition builder interface. Its two-phase verifier teaches a reusable market reasoning pattern from an accepted task, inspects and approves the proposal, proves exact material use, crosses a real ACE restart, proves exact later use, retires the revision, and requires subsequent selection to fail closed.
The verifier imports no Core internals and remains outside the inert wheel. See the external GC1 journey and the public 0.4.4 execution record. The journey passed from a clean public-index installation, crossed a real API restart over durable state, and rejected a distinct required use after retirement. ACE Core owns the final GC1 roadmap reconciliation.
Use Python 3.12 and the locked environment:
uv sync --frozen --no-install-project
uv run --no-sync pytest
uv run --no-sync pytest tests/test_release_contract.py
uv run --no-sync ruff check --no-cache tests scripts/gc1_external_consumer.py
uv run --no-sync ruff format --check --no-cache tests scripts/gc1_external_consumer.pyThe authoritative artifact hashes, clean-install evidence, cross-domain GI2 proof, and limitations are recorded in the 0.6.0 release record. The GC1 consumer evidence is a later additive proof over the unchanged inert 0.6.0 artifact.
- A pack contains no imperative control flow or credentials.
- Source repetition is not independent corroboration.
- Claims retain attribution and corrections append rather than rewrite history.
- Installing a pack does not compile, activate, authorize, execute, deliver, or publish anything.
- Models may propose; deterministic policy and explicit human authority govern activation and consequential use.
- Content creation, campaign activation, publishing, and project management are downstream consumers, not part of this package.
The Market Intelligence roadmap owns current domain direction, and release history is
in CHANGELOG.md. Core, World, and Market version independently; each compatibility
window advances only with its own conformance and public-artifact evidence.
Apache-2.0. See LICENSE and NOTICE. Existing work is copyright Edwin
Amirian; contributors retain copyright in their contributions and license them under Apache-2.0.