№ 05 · PROCESSREC / source-inventory-process
candidate

source inventory process

The repository bootstrap and source inventory process that extracted the Radium design system, preserved the archive, and documented package structure for later implementation work.

Source inventory report and Radium handoff material.

  • source inventory
  • vendor boundary
  • Radium
  • governance
DomaingovernanceVersion0.1.0Updated2026-07-01MaintainerazwerksProofpartial

Overview

01

What it is

The repository bootstrap and source inventory process that extracted the Radium design system, preserved the archive, and documented package structure for later implementation work.

Canonical facts

Domain
governance
Version
0.1.0
Updated
2026-07-01
Maintainer
azwerks
Proof
partial
  • The inventory documents extracted source structure and checksums, not design-system authorship or final website behavior.
  • The vendor package remains read-only and is not maintained from this site repository.

How the record thinks

02

Key decisions

01

Decision

How should extracted design-system source be treated?

ChosenKeep `vendor/azwerks-design-system/` read-only unless the user explicitly authorizes a vendor change.

The design system is the source of truth for Radium components, tokens, contracts, and handoff material.

Alternatives considered

  • Patch vendor source during site implementation — Would make provenance and future updates harder to audit.
  • Copy components into the site by default — Would fork existing coded components and increase drift risk.

Consequences accepted

  • Compatibility work must live in the website implementation layer.
  • Reports must document any adapter or shim used to consume vendor components.
Recorded
2026-06-30
Source
source inventory and agent rules

Lineage

03

History

Operations

Source inventory

  1. Source inventory2026-06-30

    completed

    Extract design-system source

    Extracted the provided Radium design-system archive into the read-only vendor location.

    Intent
    Make the existing coded design system available for planning and implementation without changing its source.
    Action
    Placed extracted package files under `vendor/azwerks-design-system/` and preserved the original archive separately.
    Result
    Future implementation work can inspect the package root, components, tokens, tests, and handoff files.

    The extraction records source availability, not website integration quality.

  2. Source inventory2026-06-30

    completed

    Document source inventory

    Created the source inventory report with archive metadata, package identity, foundation files, component inventory, and risks.

    Intent
    Give later implementation prompts a precise map of the Radium package.
    Action
    Read package metadata, inspected required folders, and recorded the design-system structure under `docs/`.
    Result
    The repository has a report-backed source map for design-system consumption.

    The inventory will need refreshing if the vendor package changes.

How do you know?

04

Evidence

02

Design-system source inventory report

reviewed

Documents the extracted Radium package, checksum, package identity, structure, foundation files, components, templates, tests, and handoff materials.

File:
docs/azwerks-design-system-source-inventory-v1.0.md
Scope:
source inventory

The report documents repository intake, not final public website behavior.

Radium component manifest

reviewed

Provides the component index used to identify existing Radium components instead of recreating them.

File:
vendor/azwerks-design-system/handoff/design-system/component-manifest.md
Source:
vendor handoff

Unresolved

05

Open matters

01

Matter ledger

Open matters stay visible and separate from decisions.

Open source matters

  1. Open questionmat-source-inventory-vendor-version2026-07-01

    open

    Refresh inventory when vendor source changes

    The source inventory is accurate for the extracted Radium package currently in the repository.

    Position
    Treat the report as versioned source evidence and update it only when the vendor package changes.

    The website must not silently drift from the documented package version.

Links

06

Relations

Relations

How source inventory process relates to the rest of the register.

Source dependencies

COLOPHON · № 05REC / source-inventory-process
Created
Updated
Record ID
REC / source-inventory-process
Version
0.1.0
State
candidate
Maintained by
azwerks
Derived from
Source inventory report and Radium handoff material.

LimitsInventory record only; it does not assert final production readiness.