aw-spec-cli 0.1.5 → 0.1.7

package/assets/.aw-spec/scripts/python/validate_okf.py

@@ -1,349 +0,0 @@
-#!/usr/bin/env python3
-"""validate_okf.py — conformance checker for OKF v0.1 bundles.
-
-Implements OKF §9 conformance rules as ERRORs and the spec's soft
-guidance as WARNINGs:
-
-ERRORS (bundle is non-conformant):
-  E1  Non-reserved .md file has no parseable YAML frontmatter block, or
-      could not be read.
-  E2  Frontmatter lacks a non-empty `type` field.
-  E3  Reserved file structure violations:
-      - index.md with frontmatter anywhere except the bundle root
-        (root index.md may carry only okf_version per §11)
-      - log.md date headings not in ISO 8601 YYYY-MM-DD form (§7)
-  E4  log.md date block missing a required `Commit: \\`<sha>\\`` line, or
-      the line is present but not a valid hex commit SHA. This is an
-      ERROR because /speckit.okf.update depends on it to resume.
-
-WARNINGS (consumers must tolerate; reported for quality):
-  W0  PyYAML not installed — using the lenient fallback parser.
-  W1  Missing recommended frontmatter (title, description).
-  W2  Broken bundle-internal links (may be not-yet-written knowledge).
-  W3  Directory containing concepts but no index.md.
-  W4  Concept body is empty.
-  W5  Possible secret-looking string in a file.
-  W6  A `source_files` entry does not exist on disk (may be pending
-      reconciliation by /speckit.okf.update).
-  W7  Possible duplicate concept: another file shares the same
-      `type` + `title`.
-  W8  Concept has unresolved `open_questions` (run /speckit.okf.clarify).
-
-Usage: validate_okf.py <bundle_dir> [--config PATH] [--exclude GLOB]...
-                        [--repo-root PATH] [--json]
-Exit code 0 if conformant (warnings allowed), 1 if non-conformant, 2 on
-bad usage.
-
-Only stdlib is required; PyYAML is used if available for stricter YAML
-parsing, with a lenient fallback otherwise.
-"""
-
-import argparse
-import fnmatch
-import json
-import os
-import re
-import sys
-
-try:
-    import yaml  # type: ignore
-    HAVE_YAML = True
-except ImportError:
-    HAVE_YAML = False
-
-RESERVED = {"index.md", "log.md"}
-DATE_HEADING = re.compile(r"^##\s+(\d{4}-\d{2}-\d{2})\s*$")
-COMMIT_LINE = re.compile(r"^Commit:\s+`([0-9a-fA-F]{7,40})`\s*$")
-LINK = re.compile(r"\[[^\]]*\]\(([^)]+)\)")
-SECRET_PATTERNS = [
-    # key: "value" / key = 'value' (quoted)
-    re.compile(r"(?i)(api[_-]?key|secret|password|token)\s*[:=]\s*['\"][A-Za-z0-9+/_\-]{16,}['\"]"),
-    # key: value / key = value (unquoted)
-    re.compile(r"(?i)(api[_-]?key|secret|password|token)\s*[:=]\s*[A-Za-z0-9+/_\-]{16,}\b"),
-    # AWS-style access key ID
-    re.compile(r"\bAKIA[0-9A-Z]{16}\b"),
-    # PEM private key block start
-    re.compile(r"-----BEGIN (RSA |EC |OPENSSH |)PRIVATE KEY-----"),
-]
-
-errors: list[str] = []
-warnings: list[str] = []
-concept_meta: list[tuple[str, str, str]] = []  # (rel, type, title)
-
-
-def split_frontmatter(text: str):
-    """Return (frontmatter_str or None, body)."""
-    if not text.startswith("---"):
-        return None, text
-    parts = text.split("\n")
-    if parts[0].strip() != "---":
-        return None, text
-    for i in range(1, len(parts)):
-        if parts[i].strip() == "---":
-            return "\n".join(parts[1:i]), "\n".join(parts[i + 1:])
-    return None, text  # unterminated block
-
-
-def parse_yaml(fm: str):
-    """Parse frontmatter; return dict or None on failure."""
-    if HAVE_YAML:
-        try:
-            data = yaml.safe_load(fm)
-            return data if isinstance(data, dict) else None
-        except yaml.YAMLError:
-            return None
-    # Lenient fallback: top-level "key: value" lines only.
-    data = {}
-    for line in fm.splitlines():
-        if not line.strip() or line.startswith(("#", " ", "\t", "-")):
-            continue
-        if ":" not in line:
-            return None
-        k, _, v = line.partition(":")
-        data[k.strip()] = v.strip().strip("'\"")
-    return data
-
-
-def read_text(path: str) -> tuple[str, None] | tuple[None, str]:
-    """Read a file as text; return (text, None) or (None, error_message)."""
-    try:
-        with open(path, encoding="utf-8", errors="replace") as f:
-            return f.read(), None
-    except OSError as e:
-        return None, str(e)
-
-
-def check_concept(path: str, rel: str, bundle: str, repo_root: str):
-    text, err = read_text(path)
-    if text is None:
-        errors.append(f"E1 {rel}: could not read file ({err})")
-        return
-    fm, body = split_frontmatter(text)
-    if fm is None:
-        errors.append(f"E1 {rel}: missing or unterminated YAML frontmatter block")
-        return
-    data = parse_yaml(fm)
-    if data is None:
-        errors.append(f"E1 {rel}: frontmatter is not parseable YAML")
-        return
-    t = data.get("type")
-    if not (isinstance(t, str) and t.strip()):
-        errors.append(f"E2 {rel}: frontmatter has no non-empty `type` field")
-    for field in ("title", "description"):
-        if not data.get(field):
-            warnings.append(f"W1 {rel}: missing recommended field `{field}`")
-    if not body.strip():
-        warnings.append(f"W4 {rel}: concept body is empty")
-    check_links(body, rel, os.path.dirname(path), bundle)
-    check_source_files(data, rel, repo_root)
-    check_open_questions(data, rel)
-    if isinstance(t, str) and t.strip() and data.get("title"):
-        concept_meta.append((rel, t.strip(), str(data["title"]).strip()))
-    for pattern in SECRET_PATTERNS:
-        if pattern.search(text):
-            warnings.append(f"W5 {rel}: possible secret-looking value — review before sharing")
-            break
-
-
-def check_source_files(data: dict, rel: str, repo_root: str):
-    sf = data.get("source_files")
-    if not isinstance(sf, list):
-        return
-    for entry in sf:
-        if not isinstance(entry, str) or not entry.strip():
-            continue
-        candidate = os.path.join(repo_root, entry)
-        if not os.path.exists(candidate):
-            warnings.append(f"W6 {rel}: source_files entry '{entry}' does not exist")
-
-
-def check_open_questions(data: dict, rel: str):
-    oq = data.get("open_questions")
-    if not isinstance(oq, list):
-        return
-    pending = [q for q in oq if isinstance(q, str) and q.strip()]
-    if pending:
-        n = len(pending)
-        warnings.append(
-            f"W8 {rel}: {n} unresolved open question{'s' if n != 1 else ''} "
-            f"— run /speckit.okf.clarify"
-        )
-
-
-def check_links(body: str, rel: str, filedir: str, bundle: str):
-    for target in LINK.findall(body):
-        target = target.split("#")[0].strip()
-        if not target or "://" in target or target.startswith("mailto:"):
-            continue
-        if target.startswith("/"):
-            dest = os.path.join(bundle, target.lstrip("/"))
-        else:
-            dest = os.path.join(filedir, target)
-        # Directory links (progressive disclosure) are fine if the dir exists.
-        if not (os.path.exists(dest) or os.path.exists(dest.rstrip("/"))):
-            warnings.append(f"W2 {rel}: broken link -> {target}")
-
-
-def check_index(path: str, rel: str, is_root: bool, bundle: str):
-    text, err = read_text(path)
-    if text is None:
-        errors.append(f"E1 {rel}: could not read file ({err})")
-        return
-    fm, body = split_frontmatter(text)
-    if fm is not None:
-        if not is_root:
-            errors.append(f"E3 {rel}: index.md must not contain frontmatter (only the bundle root may, per §11)")
-        else:
-            data = parse_yaml(fm) or {}
-            extra = set(data) - {"okf_version"}
-            if extra:
-                errors.append(f"E3 {rel}: root index.md frontmatter may only declare okf_version (found: {sorted(extra)})")
-    check_links(body if fm is not None else text, rel, os.path.dirname(path), bundle)
-
-
-def check_log(path: str, rel: str):
-    text, err = read_text(path)
-    if text is None:
-        errors.append(f"E1 {rel}: could not read file ({err})")
-        return
-    lines = text.splitlines()
-    for i, ln in enumerate(lines):
-        if not ln.startswith("## "):
-            continue
-        stripped = ln.rstrip()
-        if not DATE_HEADING.match(stripped):
-            errors.append(f"E3 {rel}: log heading not ISO 8601 YYYY-MM-DD: '{stripped}'")
-            continue
-        # Look for a "Commit: `<sha>`" line before the next date heading.
-        found_sha = None
-        for j in range(i + 1, len(lines)):
-            if lines[j].startswith("## "):
-                break
-            m = COMMIT_LINE.match(lines[j].strip())
-            if m:
-                found_sha = m.group(1)
-                break
-        if found_sha is None:
-            errors.append(f"E4 {rel}: date block '{stripped}' missing required 'Commit: `<sha>`' line")
-
-
-def find_repo_root(bundle: str) -> str:
-    p = bundle
-    while True:
-        if os.path.isdir(os.path.join(p, ".git")):
-            return p
-        parent = os.path.dirname(p)
-        if parent == p:
-            return os.path.dirname(bundle)
-        p = parent
-
-
-def load_config_excludes(path: str) -> list[str]:
-    if not path or not os.path.isfile(path):
-        return []
-    text, err = read_text(path)
-    if err is not None or text is None:
-        return []
-    if HAVE_YAML:
-        try:
-            data = yaml.safe_load(text) or {}
-        except yaml.YAMLError:
-            return []
-        excl = (data.get("okf") or {}).get("exclude") or []
-        return [str(x) for x in excl if isinstance(x, str)]
-    # Lenient fallback: scan for an `exclude:` block of `- "glob"` lines.
-    globs = []
-    in_exclude = False
-    for line in text.splitlines():
-        stripped = line.strip()
-        if re.match(r"^exclude\s*:\s*$", stripped):
-            in_exclude = True
-            continue
-        if in_exclude:
-            m = re.match(r"^-\s*['\"]?([^'\"#]+)['\"]?\s*(#.*)?$", stripped)
-            if m:
-                globs.append(m.group(1).strip())
-                continue
-            if stripped and not stripped.startswith("#"):
-                in_exclude = False
-    return globs
-
-
-def is_excluded(rel: str, patterns: list[str]) -> bool:
-    return any(fnmatch.fnmatch(rel, pat) for pat in patterns)
-
-
-def main() -> int:
-    parser = argparse.ArgumentParser(
-        description="Conformance checker for OKF v0.1 knowledge bundles.",
-    )
-    parser.add_argument("bundle_dir", help="Path to the knowledge bundle directory")
-    parser.add_argument("--config", help="Path to okf-config.yml (exclude list is honored)")
-    parser.add_argument("--exclude", action="append", default=[], help="Glob to exclude (repeatable)")
-    parser.add_argument("--repo-root", help="Repo root for resolving source_files (default: nearest .git above bundle_dir)")
-    parser.add_argument("--json", action="store_true", help="Emit machine-readable JSON instead of text")
-    args = parser.parse_args()
-
-    if not os.path.isdir(args.bundle_dir):
-        parser.error(f"{args.bundle_dir} is not a directory")
-
-    bundle = os.path.abspath(args.bundle_dir)
-    repo_root = os.path.abspath(args.repo_root) if args.repo_root else find_repo_root(bundle)
-    exclude_patterns = load_config_excludes(args.config) + list(args.exclude)
-
-    if not HAVE_YAML:
-        warnings.append("W0 (global): PyYAML not installed — using lenient fallback parser, results may be less strict")
-
-    concepts = 0
-    for dirpath, dirnames, filenames in os.walk(bundle):
-        dirnames[:] = [d for d in dirnames if not d.startswith(".")]
-        rel_dir = os.path.relpath(dirpath, bundle)
-        mds = [
-            f for f in filenames
-            if f.endswith(".md") and not is_excluded(
-                os.path.relpath(os.path.join(dirpath, f), bundle), exclude_patterns
-            )
-        ]
-        if any(f not in RESERVED for f in mds) and "index.md" not in mds:
-            warnings.append(f"W3 {rel_dir or '.'}: directory has concepts but no index.md")
-        for f in mds:
-            path = os.path.join(dirpath, f)
-            rel = os.path.relpath(path, bundle)
-            if f == "index.md":
-                check_index(path, rel, dirpath == bundle, bundle)
-            elif f == "log.md":
-                check_log(path, rel)
-            else:
-                concepts += 1
-                check_concept(path, rel, bundle, repo_root)
-
-    # W7: duplicate (type, title) pairs across the bundle.
-    seen: dict[tuple[str, str], str] = {}
-    for rel, t, title in concept_meta:
-        key = (t.lower(), title.lower())
-        if key in seen:
-            warnings.append(f"W7 {rel}: possible duplicate concept — same type+title as {seen[key]}")
-        else:
-            seen[key] = rel
-
-    if args.json:
-        print(json.dumps({
-            "concepts": concepts,
-            "errors": errors,
-            "warnings": warnings,
-            "result": "NON-CONFORMANT" if errors else "CONFORMANT",
-        }, indent=2))
-    else:
-        print(f"OKF validation of {bundle}")
-        print(f"  concepts: {concepts}  errors: {len(errors)}  warnings: {len(warnings)}\n")
-        for e in errors:
-            print(f"  ERROR   {e}")
-        for w in warnings:
-            print(f"  WARNING {w}")
-        print("\nRESULT:", "NON-CONFORMANT" if errors else "CONFORMANT (OKF v0.1)")
-
-    return 1 if errors else 0
-
-
-if __name__ == "__main__":
-    sys.exit(main())

package/assets/.aw-spec/templates/constitution-domain-template.md

@@ -1,75 +0,0 @@
-# [PROJECT_NAME] Constitution — [DOMAIN_NAME] Addenda
-<!-- Example: Medicinal Product Registry Constitution — Pharma Addenda -->
-<!--
-  AppWeaver split-constitution model. This is the DOMAIN half — the domain
-  addenda derived from docs/<domain>-constitution.md + the domain rule files
-  (docs/domainspecs/<domain>/…). It carries ONLY domain-specific material:
-  domain principles (XVI+), domain identifiers/terminology, regulatory regime,
-  interoperability surfaces, and domain governance overrides.
-
-  It EXTENDS the paired constitution.technical.md — it does not restate the
-  technical principles (I–XV) or the base governance; it references them and adds
-  the domain layer on top ("Extends technology X and XIV with …").
-
-  Loading policy: this file is a SPECIFY-only standing input and a GATE checklist.
-  It is deliberately NOT loaded by design or implement — domain reaches those
-  phases only through the spec. Expand the principle slots to the full domain set
-  from the domain addenda — the three shown are a scaffold, not a limit.
-
-  THIN AUTHORITY: each principle is ONE declarative, testable line + a "→ [doc.md]"
-  pointer to its rule doc. Do NOT restate the rule doc's detail here — this file says
-  WHICH domain rules are supreme/non-negotiable and adopted; the domain docs (also
-  loaded in specify) carry the detail. That keeps the authority/detail overlap to one line.
--->
-
-## Adopted Modelling Standard
-<!--
-  DDD is the ratified domain-modelling standard, and it is the ONE technical principle
-  that specify needs (specify loads THIS file, not constitution.technical). State it here
-  as a thin authority line so specify carries the DDD mandate in its constitution frame —
-  the detail lives in the rule docs (both loaded in specify), do NOT restate it.
--->
-Domain modelling follows **Principle III — Domain-Driven Design (NON-NEGOTIABLE)** of
-the technical base → docs/domain/domain-driven-design.md (generic tactical patterns) +
-docs/domainspecs/[DOMAIN]/domain-driven-design.domain.md (this domain's canonical model).
-The spec expresses the model in DDD terms (ubiquitous language, aggregates + roots,
-entities vs value objects, aggregate-owned invariants, bounded context) as domain MODEL,
-never code.
-
-## Domain Principles
-<!-- Numbered to CONTINUE the technical base (which ends at XV): start at XVI. -->
-
-### [PRINCIPLE_16_NAME]
-<!-- Example: XVI. Pharmaceutical Product Identification (NON-NEGOTIABLE) -->
-[PRINCIPLE_16_DESCRIPTION]
-<!-- Example: NDC modeled as a Value Object with discrete Labeler/Product/Package segments; uniqueness enforced; validation rules configurable; no invented codes; model aligns with ISO IDMP concepts. Cite docs/domainspecs/<domain>/ sources. -->
-
-### [PRINCIPLE_17_NAME]
-<!-- Example: XVII. Domain Terminology & Classification (NON-NEGOTIABLE) -->
-[PRINCIPLE_17_DESCRIPTION]
-<!-- Example: Coded data uses standard terminologies; every coded field is a Codeable value object; lookup/validation via the Terminology module; no invented or free-text codes. -->
-
-### [PRINCIPLE_18_NAME]
-<!-- Example: Continue XVIII+ from the domain addenda (e.g. Regulatory Compliance: Audit/Provenance/Versioning; Lifecycle Integrity; Interoperability Readiness). Add one '### ' block per domain principle; state which technical principle each EXTENDS. -->
-[PRINCIPLE_18_DESCRIPTION]
-<!-- Example: Immutable append-only audit records; full version history; retirement is a logical state change, never a hard delete. Extends technology X and XIV with domain compliance controls. -->
-
-## Domain Folder Additions
-<!-- Example: Pharma Folder Additions -->
-
-[FOLDER_ADDITIONS_CONTENT]
-<!-- Example: Interop/Fhir + Hl7v2 adapters, InteropTests, terminology seed fixtures, and provenance/version-history stores. See docs/domainspecs/<domain>/folder-structure.domain.md. These ADD to the base layout in constitution.technical.md. -->
-
-## Regulatory Posture & Security Addenda
-
-[REGULATORY_POSTURE_CONTENT]
-<!-- Example: Regulatory-compliance readiness (auditability, traceability, data integrity, provenance); data-integrity expectations (e.g. ALCOA+/GxP); identifier/terminology/standard alignment; data residency. Zero-trust posture; change-authority enforcement; data classification (public vs sensitive/pre-market/externally-sourced). Cite docs/domainspecs/<domain>/ + docs/security/*.domain.md. -->
-
-## Domain Governance Overrides
-<!-- Extends the Governance section of constitution.technical.md with domain-specific change authority. -->
-
-[DOMAIN_GOVERNANCE_CONTENT]
-<!-- Example: Mandatory approver for any identifier/classification/lifecycle-rule change (e.g. Regulatory/Compliance Officer); Domain Owners per bounded context; review cadence tied to regulatory/terminology releases; exception/waiver process. The base amendment procedure + SemVer policy in constitution.technical.md still apply. -->
-
-**Version**: [CONSTITUTION_VERSION] | **Ratified**: [RATIFICATION_DATE] | **Last Amended**: [LAST_AMENDED_DATE]
-<!-- Example: Version: 1.0.0 | Ratified: 2026-06-13 | Last Amended: 2026-06-13. Versions INDEPENDENTLY of constitution.technical.md — e.g. a WHO ATC annual update bumps this file only. -->

package/assets/.aw-spec/templates/constitution-technical-template.md

@@ -1,70 +0,0 @@
-# [PROJECT_NAME] Constitution — Technical Base
-<!-- Example: Medicinal Product Registry Constitution — Technical Base -->
-<!--
-  AppWeaver split-constitution model. This is the TECHNICAL half — the
-  domain-agnostic constitution derived from docs/technology-constitution.md
-  (Core Principles I–XV, base governance, folder/convention pointers) + the base
-  AI rules (docs/glossary/ai-rules.md). It carries NO domain-specific principle,
-  identifier, terminology, or regulatory rule — those live in the paired
-  constitution.domain.md, authored from the domain addenda.
-
-  This file is the standing technical authority for the TECHNICAL authoring phases —
-  DESIGN and IMPLEMENT (specify loads constitution.domain, not this; the gates load
-  neither). Keeping it domain-free is what lets design author architecture from "spec
-  + technical docs only" and lets the tech base stay swappable. Expand the principle
-  slots to the full I–XV set from the technology base — the five shown are a scaffold,
-  not a limit. Do NOT add domain principles here.
-
-  THIN AUTHORITY: each principle is ONE declarative, testable line + a "→ [doc.md]"
-  pointer to its rule doc. Do NOT restate the rule doc's detail here — this file says
-  WHICH rules are supreme/non-negotiable and adopted; the docs (also loaded in the
-  phase) carry the detail. That keeps the authority/detail overlap to one line.
--->
-
-## Core Principles
-
-### [PRINCIPLE_1_NAME]
-<!-- Example: I. Modular Monolith with Vertical Slices (NON-NEGOTIABLE) -->
-[PRINCIPLE_1_DESCRIPTION]
-<!-- Example: Single deployable service partitioned into modules; each module = Domain/Features/Persistence/Shared; each feature is a self-contained vertical slice; no cross-module Domain coupling; no horizontal service layers. -->
-
-### [PRINCIPLE_2_NAME]
-<!-- Example: II. Clean Architecture Dependency Rule (NON-NEGOTIABLE) -->
-[PRINCIPLE_2_DESCRIPTION]
-<!-- Example: Dependencies flow inward: API → Application → Domain ← Infrastructure; Domain is framework-agnostic; endpoints call IMediator, never repositories/DbContext. -->
-
-### [PRINCIPLE_3_NAME]
-<!-- Example: III. Domain-Driven Design with Rich Aggregates (NON-NEGOTIABLE) -->
-[PRINCIPLE_3_DESCRIPTION]
-<!-- Example: Access entities through aggregate roots; strongly-typed IDs; sealed validating value objects; immutable domain events; invariants enforced in the aggregate; transaction boundary = aggregate boundary. -->
-
-### [PRINCIPLE_4_NAME]
-<!-- Example: IV. CQRS via Mediator with Result Pattern (NON-NEGOTIABLE) -->
-[PRINCIPLE_4_DESCRIPTION]
-<!-- Example: All logic dispatched via the mediator; commands/queries return Result<T>; errors are Result.Failure (not exceptions); writes run in a transaction and publish domain events. -->
-
-### [PRINCIPLE_5_NAME]
-<!-- Example: Continue V–XV from the technology base (Specification-Driven Persistence, Optimistic Concurrency, Multi-Provider/Multi-Tenant Persistence, Security by Default, Observability, Cloud-Native Orchestration, REST API Standards, Test-First, Data Integration / Single Source of Truth, Evolutionary Path to Microservices). Add one '### ' block per principle. STOP at the last technical principle — domain principles (XVI+) go in constitution.domain.md. -->
-[PRINCIPLE_5_DESCRIPTION]
-<!-- Example: Keep each principle declarative and testable; mark NON-NEGOTIABLE ones explicitly; the rules live in docs/ — cite the technology-constitution.md source. -->
-
-## [SECTION_2_NAME]
-<!-- Example: Mandatory Folder Structure (base) -->
-
-[SECTION_2_CONTENT]
-<!-- Example: Module = Domain/Features/Persistence/Shared; cross-cutting files at the AppWeaver template level. See docs/architecture/folder-structure.md. Domain folder ADDITIONS are declared in constitution.domain.md, not here. -->
-
-## [SECTION_3_NAME]
-<!-- Example: Conventions, Forbidden Patterns, AI Rules & Quality Gates (base) -->
-
-[SECTION_3_CONTENT]
-<!-- Example: Naming/coding conventions, base Forbidden Patterns, CI Quality Gates (docs/governance/coding-standards.md); package governance (docs/governance/dependency-policy.md); base AI operational rules (docs/glossary/ai-rules.md). Domain overlays are referenced from constitution.domain.md. -->
-
-## Governance
-<!-- Example: Constitution supersedes README/CLAUDE.md/AGENTS.md; amendments via PR with a migration plan + SemVer bump; reviewers cite the principle number. This base governance also applies to constitution.domain.md; domain-specific approver/change-authority overrides are declared there. -->
-
-[GOVERNANCE_RULES]
-<!-- Example: Amendment procedure; SemVer-for-governance (MAJOR = weaken a NON-NEGOTIABLE or break the folder structure; MINOR = new principle or bounded context; PATCH = clarifications); compliance review on every PR; quarterly audit. The paired constitution.domain.md extends this section with domain change-authority. -->
-
-**Version**: [CONSTITUTION_VERSION] | **Ratified**: [RATIFICATION_DATE] | **Last Amended**: [LAST_AMENDED_DATE]
-<!-- Example: Version: 1.0.0 | Ratified: 2026-06-13 | Last Amended: 2026-06-13. This file versions INDEPENDENTLY of constitution.domain.md — a technical-base change need not bump the domain half, and vice-versa. -->

package/assets/.aw-spec/templates/delta-design-template.md

@@ -1,69 +0,0 @@
-# Delta Design — [CR-ID]: [TITLE]
-
-**Feature (aggregate)**: [Aggregate]
-
-**Base version**: [vX.Y]   <!-- the current master design version; the design phase bumps the minor on close -->
-
-<!--
-  This delta applies to the SINGLE master design at specs/[Aggregate]/design.md —
-  never a new design doc. Classify every design change ADDED / MODIFIED / REMOVED
-  against the current master, per LAYER section (Domain · Application · API · Infra),
-  in the SAME technology-agnostic form as the master: behaviour as signatures +
-  pre/post/invariant/raises, contracts as field shapes — NO code. A new command
-  (e.g. UpdateOrder) is a new USER STORY realised as delta design elements, NOT a
-  new feature/aggregate. After this delta is applied to design.md, `implement`
-  regenerates the touched slice; regression re-tests the shared-element dependents.
--->
-
-## Change summary
-
-[One paragraph: what the design change is and which user story / spec delta it serves.]
-
-## ADDED — new design elements
-
-<!-- New entities/VOs/events, use-cases/handlers, endpoints, ports, adapters, and the
-     realisation of any new spec constraint/classification/contract. Serves = a spec id
-     (FR-/BR-/CN-/DC-/IC-/US-); design reads the spec, never the domain rule files. -->
-
-| Layer (§) | Element | Kind | Serves |
-|---|---|---|---|
-| Application (§2) | `[Command/Query]` + handler | use-case | US-[n] · FR-[nnn] |
-| API (§3) | `[VERB] [/route]` | endpoint | US-[n] · FR-[nnn] |
-| Domain (§1) | `[Event]` / `[VO]` | event / value object | BR-[nnn] · CN-[nnn] |
-| Infrastructure (§4.2) | `I[External]` adapter | contract realisation | IC-[nnn] |
-| Cross-cutting (§5) | [audit / retention / exposure decision] | constraint realisation | CN-[nnn] · DC-[nnn] |
-
-## MODIFIED — existing design elements
-
-<!-- Edits to elements the master already defines (add a behaviour, change a contract). -->
-
-| Layer (§) | Element | What changes | Why |
-|---|---|---|---|
-| Domain (§1) | `[Root].[Behaviour]` | add [method] + invariant | US-[n] |
-| Infrastructure (§4) | `I[Aggregate]Repository` | add [operation] | US-[n] |
-
-## REMOVED
-
-- [design element removed + why] — or `None`
-
-## Cross-layer impact
-
-[Which layer sections ripple; shared elements touched (e.g. the aggregate root);
-new migration needed? (yes/no); any contract change other systems couple to.]
-
-## Regression targets
-
-[Existing user stories / behaviours to re-verify because a shared element changed —
-e.g. re-test CreateOrder when the Order root or its repository is MODIFIED.]
-
-## New assumptions / workarounds (from this change)
-
-<!-- Anything this change defers — folds into the master's §7 / §8 ledgers on apply. -->
-
-- **DA-[n]**: [assumption to clarify later] — or `None`
-- **WA-[n]**: [structural workaround to clear later] — or `None`
-
-## On close
-
-The design phase amends the master design.md doc-first, appends the Change History
-row, bumps the version (minor), and archives this record under `changes/archive/`.

package/assets/.aw-spec/templates/delta-spec-template.md

@@ -1,60 +0,0 @@
-# Delta Spec — [CR-ID]: [TITLE]
-
-**Feature (aggregate)**: [Aggregate]
-
-**Change type**: [new-requirement | changed-requirement | defect | refactor]
-
-**Created**: [DATE]
-
-**Base version**: [vX.Y]   <!-- the current master version; close-delta bumps the minor at the end of the chain -->
-
-<!--
-  A change request is a DELTA on the feature's existing spec.md — never a new spec.
-  Classify every item ADDED / MODIFIED / REMOVED against the current master, using
-  the SAME vocabulary as the master spec: System Requirements in EARS, Business
-  Rules (BR-n) as invariants, User Stories with Given/When/Then acceptance criteria,
-  and — where the domain applies — Constraints & NFRs (CN-n), Data Classification
-  (DC-n), and Integration Contracts (IC-n). A CR that changes a retention/audit rule,
-  a data-exposure rule, or an interop obligation is a CN-/DC-/IC- delta, not a smuggled
-  code change. Adding a command (e.g. UpdateOrder to the Order aggregate) is a new
-  user story (US-n), NOT a new feature. Feature = aggregate (see spec-template.md).
--->
-
-## Change summary
-
-[One paragraph: what is changing and why.]
-
-## ADDED
-
-<!-- New user stories, system requirements, business rules, entities, or domain-lift items (CN/DC/IC). -->
-
-- **US-[n] — [title]** (Priority: P?)
-  - **Why this priority**: [the value and why it ranks here]
-  - **Exercises**: [FR-nnn, BR-nnn]
-  - **Acceptance**: Given [state], When [action], Then [outcome]
-  - **Independent test**: [how this story is verified on its own]
-- **FR-[nnn]**: WHEN [trigger] THE SYSTEM SHALL [response]   <!-- EARS — pick the fitting pattern -->
-- **BR-[nnn]**: [a new invariant that must always hold] — or `None`
-- **CN-[nnn]**: [new constraint / NFR — retention, immutability, audit, performance-as-a-limit; cite lifted source] — or `None`
-- **DC-[nnn]**: [new data-classification category or exposure rule] — or `None`
-- **IC-[nnn]**: [new integration contract / interop obligation] — or `None`
-- **Entity**: [new entity / value object + what it represents] — or `None`
-
-## MODIFIED
-
-- **FR-[nnn]**: was [old] → now [new]   <!-- keep EARS form -->
-- **BR-[nnn]**: was [old] → now [new]
-- **CN-[nnn]** / **DC-[nnn]** / **IC-[nnn]**: was [old] → now [new]
-- **US-[n]**: [what changes and why]
-
-## REMOVED
-
-- [FR / BR / CN / DC / IC / US / entity removed and why] — or `None`
-
-## Impact
-
-- **Affected FR / BR / CN / DC / IC / US / SC**: [ids]
-- **Regression risk**: [existing behaviour that must still hold — e.g. CreateOrder must still pass]
-- **On merge**: the new US-[n] is tagged `Added: (this CR)` in the master; finalize-delta
-  merges this delta into spec.md + design.md and appends the Change History row, and
-  close-delta (after analyze-slice) archives the change and bumps the minor version.