Status: pre-launch. This page describes target design; nothing on skyzai.org is live yet.

DEV-06 -- apu.bot Suggestion Flow

This flow is part of apu.bot's Cortex-gardening role; the canonical spec is a private, unpublished document.

Boundary

apu.bot is the L6 gardener over Cortex. It is not the Rosetta pipeline. It is not a watchman. It is not a silent rewriter.

Cadence Flow

Cortex graph
  -> apu.bot cadence walk
  -> detect recommend / prune / consolidate / grow opportunity
  -> create a suggestion object
  -> user reads
  -> hold / approve / reject / defer
  -> stage unsigned proposal for typed authority review
  -> private act: Natural Person signs their own change
  -> public-DAV consequence: require a complete valid bound PRISM decision receipt
     from at least two natural-person councilors binding that exact consequence
  -> PRISM records and verifies that receipt only
  -> software deterministically applies only that exact bound structural change
     after validating the complete receipt
  -> write receipts to suggestion trace and touched objects

Suggestion Object

Required fields from the spec:

Field	Meaning
id	unique suggestion identifier
type	recommend, prune, consolidate, or grow
target_node_ids	semantic objects affected
rationale	source-linked justification
confidence	apu.bot's confidence
severity	low, medium, high
status	pending, held, approved, rejected, deferred
cadence_source	daily, weekly, manual, or event-triggered
proposed_disposition	concrete change proposed
authority_receipt	null until a typed private signature or public-DAV quorum decision receipt exists
receipts	traces of accepted changes

Product Face

The product face turns the gardener into principal-facing surfaces:

• BRIEF/
• DCR-PENDING/
• WATCH/
• ARCHIVE/

These are projections of the gardener, not a second apu.bot.

Hard Rule

Suggestions are autonomous. Structural acceptance is not. Anything that merges, archives, restructures, or changes lineage requires the applicable typed authority: every exact public-DAV consequence requires a complete valid bound PRISM decision receipt from at least two natural-person councilors binding that exact consequence; PRISM records and verifies only. A Legal Person change requires lawful external authority plus every executor required by law. A Natural Person authorizes their own private act, and agents stage unsigned proposals only.