Skip to content
ContractSpec
Start here

Package manual · examples

·Examples and implementation patterns

example.organization-planning-agenda

Reference agenda workflow for ContractSpec organization-planning contracts.

examplesexamplev2.0.5experimentalservernode
@lssm-tech/example.organization-planning-agenda
bun add @lssm-tech/example.organization-planning-agenda
Package source ↗Manifest ↗

Manifest declarations describe the current workspace; they do not verify registry publication or runtime execution.

Package guide

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:

VerticalWeb monolithMobile demoExamples/docsManaged 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
  • 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 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.

Declaration builds use build:types through the shared Bun tool; build runs bundle and declaration generation. Declared exports are preserved. Generated artifacts exclude test-only files; tests/typecheck remain separate gates.

Relationships

THIS PACKAGEexample.organization-planning-agenda7 import paths

Arrows point from a package to its direct dependency. Counts are derived from captured workspace manifests.

6 declarations

Declared capabilities

This manifest does not declare a capability catalogue. Use the guide, import map and source to assess the package.

Scripts

  • buildcontractspec-bun-build build
  • typechecktsgo --noEmit
  • testbun test
  • smokebun test src/example.smoke.test.ts
  • preflightbun run build && bun run typecheck && bun run test && bun run smoke
  • build:bundlecontractspec-bun-build transpile
  • build:typescontractspec-bun-build types