@nusoft/nuflow-pack-nuos-build-catalogue

NuFlow workflow pack that turns the NuOS build catalogue — work units, decisions, open questions, personas — into NuFlow workflow instances with state, audit chain, policy gates, and lifecycle.

After this pack lands fully (WU 111), the markdown files in nuos/docs/build/*/ become a generated read-only view of NuFlow workflow state. Hand-edits stop being the primary mechanism; workflow intents become it.

Status

0.0.1 — Phase A scaffolding only. Workflow handles are stubs that throw on buildWriteIntent. Bodies land across Phases B–G of WU 111.

| Phase | Workflow handles wired | | --- | --- | | A (this release) | All 10 handles defined as stubs; pack registers cleanly with a NuFlow runtime. | | B | work_unit.create | | C | work_unit.advance_status | | D | work_unit.add_acceptance_criterion, work_unit.tick_acceptance_criterion | | E | decision.create, decision.supersede, open_question.create, open_question.resolve | | F | persona.create | | G | regenerate_markdown_catalogue (+ migration runner in the CLI repo) |

Workflow types

| Type | Purpose | | --- | --- | | work_unit.create | Create a new WU with the D046 six-field outcome shape (or N/A — infrastructure WU). | | work_unit.advance_status | Move a WU through the legal status states (proposed → ready → in_progress → in_review → completed). Gate at → completed: every AC must have evidence. | | work_unit.add_acceptance_criterion | Add an AC to an existing WU. | | work_unit.tick_acceptance_criterion | Mark an AC met with non-empty evidence. | | decision.create | Create a D-NNN; immutable once committed. | | decision.supersede | Mark a D-NNN superseded; flips the original accepted → superseded and writes a superseded_by link. | | open_question.create | Create a Q-NNN. | | open_question.resolve | Convert a Q-NNN into a D-NNN via a chained decision.create. | | persona.create | Create a P-NNN with the seven dimensions + acid-test (per D046). | | regenerate_markdown_catalogue | Read workflow state and regenerate the markdown files. Used today as a verification gate (Mode 1); becomes the canonical write path post-WU-113 (Mode 2). |

Use

import { createNuOS } from '@nusoft/nuos';
import { nuosBuildCataloguePack } from '@nusoft/nuflow-pack-nuos-build-catalogue';

const nuos = await createNuOS({ /* trifecta config */ });
nuosBuildCataloguePack.register(nuos.nuflow);

Once registered, the pack's workflow types are resolvable on the runtime. The CLI in nuos-build-catalogue is the recommended consumer.

Related

• WU 111 — docs/build/work-units/111-work-units-as-nuflow-instances.md (in the nuos/ catalogue) — the full spec for what this pack ships.
• D046 — docs/build/decisions/D046-odd-planning-becomes-phase-1-of-nuos-build.md — the six-field outcome shape and the persona register.
• D041 — docs/build/decisions/D041-nuos-meta-package-integration-layer.md — meta-package consumption pattern.
• D045 — docs/build/decisions/D045-nuos-packages-caret-ranges-never-exact-pins.md — caret ranges for @nusoft/* deps.

License

Proprietary; see LICENSE.