plan-module · supabase_json

AD Competitive Intelligence plan-module M-04

plan-module artifact · for AD Competitive Intelligence · phase M-04 · status complete

Planning Surface

Use this to decide what happens next.

Status

complete

Phase

M-04

tasks

id	role	title	acceptance	deliverables
M-04.T1	developer	Implement signal review state machine	- Only approved signals can publish. - Every status change records actor/time/reason.	- review states - approve/reject/edit APIs - audit log
M-04.T2	developer	Create operator review queue contract	- Queue includes evidence, observed fact, inference, AD implication, confidence, and source authority. - Operators can inspect source URLs.	- API shape and UI data contract for draft signals

Agent Handoff

Start Here

id	role	title	acceptance	deliverables
M-04.T1	developer	Implement signal review state machine	- Only approved signals can publish. - Every status change records actor/time/reason.	- review states - approve/reject/edit APIs - audit log
M-04.T2	developer	Create operator review queue contract	- Queue includes evidence, observed fact, inference, AD implication, confidence, and source authority. - Operators can inspect source URLs.	- API shape and UI data contract for draft signals

Completion Evidence

No explicit evidence field yet. Require tests, screenshots, linked PRs, or reviewed outputs before marking complete.

Artifact Shape

repo: name: string, ownership: string, local_path: string, relationship_to_redkey: string
tasks: 2 items
module id: M-04
module name: Analyst Review and Governance Workflow
product suite: name: string, products: object, repo_path: string, migration_source: object
schema version: 1.0
depends on modules: 1 item

Structured Payload

Machine-readable source fields

repo

name

KnowledgeVault

ownership

Standalone production AD suite repo. It should contain KnowledgeVault core, the production KV app, Executive SEO, AD Competitive Intelligence/analytics, and Ask AD integration. RedKey remains platform/orchestration, not the product implementation home.

local path

/Users/justinking/Vaults/Projects/KnowledgeVault

relationship to redkey

RedKey stores Studio artifacts, agent orchestration, and shared platform infrastructure; product code should graduate into this standalone KnowledgeVault repo.

tasks

id	role	title	acceptance	deliverables
M-04.T1	developer	Implement signal review state machine	- Only approved signals can publish. - Every status change records actor/time/reason.	- review states - approve/reject/edit APIs - audit log
M-04.T2	developer	Create operator review queue contract	- Queue includes evidence, observed fact, inference, AD implication, confidence, and source authority. - Operators can inspect source URLs.	- API shape and UI data contract for draft signals

module id

M-04

module name

Analyst Review and Governance Workflow

product suite

name

KnowledgeVault AD Suite

products

id	name	purpose
knowledgevault-core	KnowledgeVault Core	Capture retiring expert and product knowledge into governed, searchable assets.
knowledgevault-app	KnowledgeVault App	Production application surface for capture, search, dashboards, admin, and AD/member workflows.
executive-seo	Executive SEO	Distributor digital visibility intelligence and CEO-level opportunity prioritization.
competitive-intelligence	AD Competitive Intelligence	Monitor Grainger and Fastenal public signals, produce reviewed analytics/briefs, and feed Ask AD.
ask-ad	Ask AD	Suite-level cited advisor across KnowledgeVault, SEO, and Competitive Intelligence.

repo path

/Users/justinking/Vaults/Projects/KnowledgeVault

migration source

seo app

AD SEO app implementation/artifacts currently live outside this repo and should be migrated or integrated as a product module before production packaging.

knowledgevault app

/Users/justinking/Vaults/Projects/redk3y/apps/knowledgevault

schema version

1.0

depends on modules

M-03