Skip to content

Commit b29e74d

Browse files
mpstatonclaude
andcommitted
doc(context-v): normalize frontmatter across 181 files
The tree-wide frontmatter sweep only: site_uuid and hex_code minted, editorial draft dates filled, ledes and summaries added where missing. No prose touched. Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com> Claude-Session: https://claude.ai/code/session_01H4m2VTBgBQY3bErHAGGdjw
1 parent 92f9cba commit b29e74d

181 files changed

Lines changed: 975 additions & 203 deletions

File tree

Some content is hidden

Large Commits have some content hidden by default. Use the searchbox below for content that may be hidden.

context-v/README.md

Lines changed: 4 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -7,6 +7,10 @@ status: Active
77
tags:
88
- Context-Vigilance
99
- Convention
10+
site_uuid: 60a76104-2421-4263-ad44-405d9dfabfaa
11+
hex_code: bxhzq2
12+
date_authored_initial_draft: 2026-05-12
13+
date_authored_current_draft: 2026-05-12
1014
---
1115

1216
This directory follows the Lossless Group **context-vigilance** convention.

context-v/backlogs/2026-08-02_Hitlist-for-Sprint.md

Lines changed: 4 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -17,6 +17,10 @@ tags:
1717
- Sprint
1818
- Augment-It
1919
- Triage
20+
site_uuid: df463dec-bacc-4c41-9a64-585feb10b2af
21+
hex_code: bbj8uo
22+
date_authored_initial_draft: 2026-08-02
23+
date_authored_current_draft: 2026-08-02
2024
---
2125

2226
# Sprint Hitlist — 2026-08-02

context-v/blueprints/Augment-It-as-Working-App-and-Architecture-Demo.md

Lines changed: 6 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -1,6 +1,7 @@
11
---
22
title: "Augment-It as Working App and Architecture Demonstration"
3-
lede: "Augment-it lives two lives at once — a working product that augments CRM-style record sets, and a living showcase of microservices + microfrontend + API-first architecture. This blueprint names the dual identity, draws out the tensions it creates, and codifies the discipline of evaluating every architectural and UX decision under both lenses so neither identity quietly wins."
3+
lede: >-
4+
Augment-it is a working product and a live architecture showcase at once; every decision answers to both lenses so neither quietly wins.
45
date_created: 2026-06-01
56
date_modified: 2026-06-01
67
authors:
@@ -19,6 +20,10 @@ tags:
1920
- Module-Federation
2021
- Demonstration
2122
status: Draft
23+
site_uuid: f35963fd-1426-4d7a-8d22-19fb04d037e7
24+
hex_code: 25efk5
25+
date_authored_initial_draft: 2026-06-01
26+
date_authored_current_draft: 2026-06-01
2227
---
2328

2429
# Augment-It as Working App and Architecture Demonstration

context-v/blueprints/Auth-Patterns-following-Astro-Knots-Patterns.md

Lines changed: 6 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -1,6 +1,7 @@
11
---
22
title: "Auth Patterns — Following Astro Knots Conventions in a Rsbuild + Module-Federation Shell"
3-
lede: "Augment-it isn't a pure Astro site — the shell is Rsbuild + Svelte + Module Federation, and the backend is NATS-fronted microservices with a workspace-service holding session tokens. But the Astro Knots auth conventions (session cookie, middleware gate, public allowlist, never-prerender-a-gated-route) still encode the right discipline. This blueprint translates each rule into the augment-it architecture so the audit-trail and the failure modes stay legible across the two stacks."
3+
lede: >-
4+
Astro Knots auth rules translated to Rsbuild + NATS: the middleware gate becomes a WS token check, and silent bypass is the shared risk.
45
date_created: 2026-06-01
56
date_modified: 2026-06-01
67
authors:
@@ -18,6 +19,10 @@ tags:
1819
- Module-Federation
1920
- Architecture
2021
status: Draft
22+
site_uuid: 40f18f7e-a4e7-45df-a2df-ef72d7bb06ca
23+
hex_code: aspt35
24+
date_authored_initial_draft: 2026-06-01
25+
date_authored_current_draft: 2026-06-01
2126
---
2227

2328
# Auth Patterns — Following Astro Knots Conventions

context-v/blueprints/Connecting-To-And-Using-SurrealDB.md

Lines changed: 4 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -18,6 +18,10 @@ tags:
1818
- Module-Federation
1919
- Person-Enrichment
2020
status: Draft
21+
site_uuid: b83c9250-18f1-4ffc-9715-48d82b4bfe56
22+
hex_code: 7vqdeg
23+
date_authored_initial_draft: 2026-06-21
24+
date_authored_current_draft: 2026-06-21
2125
---
2226

2327
# Connecting To And Using SurrealDB

context-v/blueprints/Module-Federation-Rsbuild-Dev-Loop-Gotchas.md

Lines changed: 6 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -1,6 +1,7 @@
11
---
22
title: "Module Federation + Rsbuild — Dev Loop Gotchas"
3-
lede: "Operational reference for the five things that bite teams adopting Module Federation 2.0 on the rsbuild stack. None of them block adoption; all of them silently cost time if you don't see them coming. Cross-origin HMR, TypeScript across federation boundaries, the rspack-escape-hatch config shape, MF 1.0 vs 2.0 documentation drift, and the smaller-than-Vite plugin ecosystem. Reference for the augment-it rewrite (and anywhere else in the family that picks the same substrate)."
3+
lede: >-
4+
Five Rsbuild + Module Federation gotchas, cross-origin HMR first: none block adoption, all cost time if you don't see them coming.
45
date_created: 2026-05-18
56
date_modified: 2026-05-18
67
authors:
@@ -17,6 +18,10 @@ tags:
1718
- Dev-Environment
1819
- Gotchas
1920
status: Draft
21+
site_uuid: b3a24dfa-9a28-412d-8b6f-37fb28e645fb
22+
hex_code: 7s4424
23+
date_authored_initial_draft: 2026-05-18
24+
date_authored_current_draft: 2026-05-18
2025
---
2126

2227
# Module Federation + Rsbuild — Dev Loop Gotchas

context-v/blueprints/Original-and-Enhanced-Record-Instances.md

Lines changed: 6 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -1,6 +1,7 @@
11
---
22
title: "Original and Enhanced Record Instances — the Record-Instance Model"
3-
lede: "augment-it does not mutate an uploaded record set, and it does not spawn a new derived set per prompt run. It keeps an immutable original import and a single mutable enhanced instance that accumulates every enrichment in a round. The user can promote an enhanced instance to be the source of the next round, so the model is generational — original → enhanced → promote → enhanced' — with an id-map that holds across every generation so the eventual write-back into the system of record always knows its target. Two classes of enhancement — lookup and judgment — flow through this model very differently."
3+
lede: >-
4+
No mutation, no derived set per run: one immutable original plus one mutable enhanced instance per round, promoted to seed the next.
45
date_created: 2026-05-21
56
date_modified: 2026-05-21
67
authors:
@@ -19,6 +20,10 @@ tags:
1920
- Write-Back
2021
- Data-Model
2122
status: Draft
23+
site_uuid: d31a21b8-8abd-4d94-8d63-911aefc448b0
24+
hex_code: 79mwri
25+
date_authored_initial_draft: 2026-05-21
26+
date_authored_current_draft: 2026-05-21
2227
---
2328

2429
# Original and Enhanced Record Instances

context-v/blueprints/Packs-and-Bundles-Pattern.md

Lines changed: 7 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -1,6 +1,7 @@
11
---
22
title: "Packs and Bundles — The Two-Tier Pattern for Entity-Profile Augmentation (and Beyond)"
3-
lede: "When augment-it needs to fan out across many sources to find verified profiles for an entity (LinkedIn + X + BlueSky + YouTube for everyone, then Candid + ProPublica + IRS 990 + Charity Navigator for a nonprofit), the right abstraction is not a single capability and not a single big prompt. It is two tiers. A **pack** is the atomic unit — one source, one microfrontend, one MCP-server microservice, one prompt-snippet, one extraction-schema, one render-config. A **bundle** is the orchestration unit — a named composition of packs with single-pass or two-pass execution, data carry-forward between passes, agent-driven pre-flight dedup against existing `helpful_links`, and a single chat verb that fires the whole thing. This blueprint codifies both."
3+
lede: >-
4+
Two tiers: a pack is one source, one remote, one schema; a bundle is a named composition of packs fired by a single chat verb.
45
date_created: 2026-05-25
56
date_modified: 2026-05-25
67
authors:
@@ -10,7 +11,7 @@ augmented_with:
1011
semantic_version: 0.0.0.3
1112
revisions:
1213
- 2026-05-25 — Initial draft.
13-
- 2026-05-25 — **Design pivot from `profiles.<source>` columns to a single `socials` JSON column per row, mirroring `helpful_links`.** Triggered by smoke-run feedback: spawning N new columns per pack obscured the result (no row-level view of which platforms were filled in) and broke the dynamic-schema discipline that "row columns are CSV-derived." New shape: one row-level column `socials: SocialProfile[]` containing all accepted pack profiles. Acceptance of a pack response routes through `row.socials.add` (replace-by-pack_id semantics — one entity has one LinkedIn) instead of `row.update` against a per-pack output_column. See §Row write-back below for the schema + capabilities.
14+
- "2026-05-25 — **Design pivot from `profiles.<source>` columns to a single `socials` JSON column per row, mirroring `helpful_links`.** Triggered by smoke-run feedback: spawning N new columns per pack obscured the result (no row-level view of which platforms were filled in) and broke the dynamic-schema discipline that \"row columns are CSV-derived.\" New shape: one row-level column `socials: SocialProfile[]` containing all accepted pack profiles. Acceptance of a pack response routes through `row.socials.add` (replace-by-pack_id semantics — one entity has one LinkedIn) instead of `row.update` against a per-pack output_column. See §Row write-back below for the schema + capabilities."
1415
- 2026-05-26 — Added §Triage Surface UX Requirements (emergent). Captures pattern-level requirements that the foundation-dataset smoke surfaced — discoveries the upfront draft didn't anticipate. Codified here so future pack/bundle implementations across the Lossless family inherit the discipline without re-hitting the same walls.
1516
tags:
1617
- Blueprint
@@ -24,6 +25,10 @@ tags:
2425
- Response-Reviewer
2526
- Verification-Pattern
2627
status: Draft
28+
site_uuid: 276d12c8-1a45-45a7-a742-6f330c540cd8
29+
hex_code: dn39ix
30+
date_authored_initial_draft: 2026-05-25
31+
date_authored_current_draft: 2026-05-25
2732
---
2833

2934
# Packs and Bundles — The Two-Tier Pattern

context-v/blueprints/Response-Row-Identity-Across-Promote.md

Lines changed: 6 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -1,6 +1,7 @@
11
---
22
title: "Response–Row Identity Across Promote — Why Responses Outlive Their Rows, and the `record_uuid`-on-Response Fix"
3-
lede: "Responses live in response-store. Rows live in row-store. When `record_set.promote` folds a parent set into a canonical, the **parent rows are deleted and new canonical rows are minted with fresh row_ids** — but the old responses survive untouched, still pointing at row_ids that no longer exist. Today there's no link from those orphaned responses back to the canonical row that inherited their accepted value, because the stable cross-derivation identity (`record_uuid`) lives only on rows, not on responses. The fix is small and additive: carry `record_uuid` on the ResponseRecord at create time, and the by-record view can resolve orphans by identity instead of by dead row_id."
3+
lede: >-
4+
Promote deletes parent rows, leaving responses pointed at dead `row_id`s; carrying `record_uuid` on the response resolves them by identity.
45
date_created: 2026-05-26
56
date_modified: 2026-05-26
67
authors:
@@ -18,6 +19,10 @@ tags:
1819
- Audit-Trail
1920
- Cross-Derivation
2021
status: Draft
22+
site_uuid: b5086f64-2b2a-4841-ae4d-73173d3461df
23+
hex_code: 54jgji
24+
date_authored_initial_draft: 2026-05-26
25+
date_authored_current_draft: 2026-05-26
2126
---
2227

2328
# Response–Row Identity Across Promote

context-v/blueprints/Spec-Kit-and-Context-V-Coexistence.md

Lines changed: 6 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -1,6 +1,7 @@
11
---
22
title: "Spec-Kit and Context-V Coexistence — How They Work Together in Augment-It"
3-
lede: "On 2026-05-18 augment-it adopted GitHub's Spec Kit (v0.8.11) alongside its existing context-v directory. This blueprint codifies how the two systems coexist: context-v holds the project's living memory (explorations, blueprints, reminders, journey docs, broader specs), and spec-kit drives implementation flow per feature (constitution → specify → plan → tasks → implement, with quality gates). The two are complementary, not competing. The 14 /speckit-* slash commands now available in Claude Code operate on .specify/, while context-v continues to be the source of truth for project memory."
3+
lede: >-
4+
context-v holds the project's living memory; spec-kit drives per-feature implementation flow. Complementary, not competing.
45
date_created: 2026-05-18
56
date_modified: 2026-05-18
67
authors:
@@ -17,6 +18,10 @@ tags:
1718
- Augment-It
1819
- AI-Co-Development
1920
status: Draft
21+
site_uuid: bba54121-19b6-4b28-9222-cbca88421923
22+
hex_code: xs6zyp
23+
date_authored_initial_draft: 2026-05-18
24+
date_authored_current_draft: 2026-05-18
2025
---
2126

2227
# Spec-Kit and Context-V Coexistence

0 commit comments

Comments
 (0)