# @lssm-tech/example.organization-planning-agenda

Buildable OPA OS example for the local/manual Organization Planning Agenda loop.

## What this demonstrates

- Hackathon EOD Mission Relay-style day plan generation.
- NDconsulting-style agenda generation with private context redaction.
- Axoperf-style deployment planning constraints and blocker evidence.
- Customer-facing booking proposals blocked behind human approval.
- Rich calendar roadmap lanes for focus blocks, agendas, booking proposals,
  approval gates, and audit artifacts.
- Notion-ready markdown and audit payloads without calendar/provider writes.

## Flagship surface matrix proof

The exported `organizationPlanningAgendaSurfaceMatrixProof` fixture documents the
three flagship rows consumed by app smoke tests and docs:

| Vertical | Web monolith | Mobile demo | Examples/docs | Managed CompanyOS seam |
|---|---|---|---|---|
| Hackathon EOD | `/companyos/opa-os` consumes `buildManagedCompanyOsOpaOsProof` from `@lssm-tech/bundle.managed-companyos`. | `mobile.opa.hackathon_eod.native` consumes the managed OPA view model. | Smoke fixture renders the day plan, markdown, approvals, and evidence IDs. | `managed-companyos.view-model.organization-planning.hackathon-eod` |
| NDconsulting mission | `/companyos/opa-os` renders the client mission agenda from the managed bundle proof. | `mobile.opa.ndconsulting_mission.native` shows agenda and approval-denial state. | Smoke fixture proves agenda plus next meeting proposal. | `managed-companyos.view-model.organization-planning.ndconsulting-mission` |
| Axoperf deployment | `/companyos/opa-os` keeps deployment blocker proof in provider-blocked/degraded mode. | `mobile.opa.axoperf_deployment.native` shows blocker priority and approval-only booking slots. | Smoke fixture documents blocker outputs and evidence IDs. | `managed-companyos.view-model.organization-planning.axoperf-deployment` |

## Evidence links

- Rich calendar proof: `organizationPlanningRichCalendarRoadmapProof` exports
  provider-free lanes and approval-blocked calendar items for docs, sandbox, and
  managed-bundle consumers.
- Web proof: `packages/apps/web-application-monolith/src/opa-os-route.test.tsx` validates that `/companyos/opa-os` consumes the managed bundle proof, emits redacted behavior signals, and keeps external effects approval-blocked.
- Static safety: run `bun run opa-os:safety` from the repository root to verify the OPA no-provider, no-raw-secret, and no-live-send boundary before release handoff.

## Running locally

From `packages/examples/organization-planning-agenda`:

- `bun run build`
- `bun run typecheck`
- `bun run test`
- `bun run smoke`
- `bun run preflight`

## Boundary

This example is intentionally local and manual. It does not import provider SDKs,
write calendars, send client messages, or approve external effects.