reference-audit 0.1.0__tar.gz

reference_audit-0.1.0/.cf-studio/config/AGENTS.md

@@ -0,0 +1,4 @@
+# Custom Agent Navigation Rules
+
+Add your project-specific WHEN rules here.
+These rules are loaded alongside the generated rules in `{cf-studio-path}/.gen/AGENTS.md`.

reference_audit-0.1.0/.cf-studio/config/README.md

@@ -0,0 +1,21 @@
+# config — User Configuration
+
+This directory contains **user-editable** configuration files.
+
+## Files
+
+- `core.toml` — project settings (system name, slug, kit references)
+- `artifacts.toml` — artifacts registry (systems, ignore patterns)
+- `AGENTS.md` — custom agent navigation rules (add your own WHEN rules here)
+- `SKILL.md` — custom skill extensions (add your own skill instructions here)
+
+## Directories
+
+- `kits/{slug}/` — kit files (SKILL.md, AGENTS.md, artifacts/, codebase/, workflows/, scripts/).
+  These are updated via `cfs update` or `cfs kit update`.
+
+## Tips
+
+- `AGENTS.md` and `SKILL.md` start empty. Add any project-specific rules or
+  skill instructions here — they will be picked up alongside the kit ones.
+- Kit files can be edited directly; `cfs kit update` shows a diff for changes.

reference_audit-0.1.0/.cf-studio/config/SKILL.md

@@ -0,0 +1,4 @@
+# Custom Skill Extensions
+
+Add your project-specific skill instructions here.
+Agent-facing skills and workflows are generated into agent integration files.

reference_audit-0.1.0/.cf-studio/config/artifacts.toml

@@ -0,0 +1,56 @@
+# Constructor Studio artifacts registry
+
+[[systems]]
+name = "ReferenceAudit"
+slug = "referenceaudit"
+kit = "sdlc"
+children = []
+
+[[systems.artifacts]]
+name = "Product Requirements"
+path = "architecture/PRD.md"
+kind = "PRD"
+traceability = "FULL"
+
+[[systems.artifacts]]
+name = "Technical Design"
+path = "architecture/DESIGN.md"
+kind = "DESIGN"
+traceability = "FULL"
+
+[[systems.artifacts]]
+name = "Decomposition"
+path = "architecture/DECOMPOSITION.md"
+kind = "DECOMPOSITION"
+traceability = "FULL"
+
+[[systems.artifacts]]
+name = "Parsing Feature"
+path = "architecture/features/parsing.md"
+kind = "FEATURE"
+traceability = "FULL"
+
+[[systems.artifacts]]
+name = "Identification & Verdict Feature"
+path = "architecture/features/identification.md"
+kind = "FEATURE"
+traceability = "FULL"
+
+[[systems.artifacts]]
+name = "Citation Alignment Feature"
+path = "architecture/features/citation-alignment.md"
+kind = "FEATURE"
+traceability = "FULL"
+
+[[systems.artifacts]]
+name = "PDF Input Feature"
+path = "architecture/features/pdf-input.md"
+kind = "FEATURE"
+traceability = "FULL"
+
+[[systems.codebase]]
+name = "Reference Audit Source"
+path = "src/reference_audit"
+extensions = [".py"]
+singleLineComments = ["#"]
+multiLineComments = [{start = '"""', end = '"""'}]

reference_audit-0.1.0/.cf-studio/config/change-impact-analysis.toml

@@ -0,0 +1,23 @@
+# Constructor Studio SDLC Kit — change-impact-analysis configuration
+# Kit-owned thresholds for the cf-sdlc-change-impact-analysis workflow.
+# This config is kit-owned and user-editable; it is NOT part of the
+# cfs-core-owned constraints.toml schema.
+
+# Days since the change after which an unchanged downstream marker is flagged stale.
+stale_flag_threshold = 30
+
+# Marker coverage (%) below which an affected downstream artifact is reported as a coverage gap.
+marker_coverage_threshold = 80
+
+# Ordered impact severity levels (highest first), used to classify affected artifacts
+# and, in release-readiness-estimation mode, to recommend a version bump.
+impact_severity_levels = ["critical", "high", "medium", "low"]
+
+# Maximum downstream cascade depth to traverse, per upstream artifact type.
+# Upstream artifacts (PRD/ADR) cascade deeper than near-code artifacts (FEATURE).
+[cascade_depth_limit]
+PRD = 5
+ADR = 5
+DESIGN = 4
+DECOMPOSITION = 3
+FEATURE = 2

reference_audit-0.1.0/.cf-studio/config/core.toml

@@ -0,0 +1,314 @@
+# Constructor Studio project configuration
+
+version = "1.0"
+project_root = ".."
+
+[install]
+version_source = "project_config"
+runtime_tracking = "ignored"
+agent_tracking = "ignored"
+kit_tracking = "tracked"
+
+[kits]
+[kits.sdlc]
+format = "CFS"
+path = "config/kits/sdlc"
+source = "github:constructorfabric/studio-kit-sdlc"
+install_mode = "copy"
+version = "v1.2.1"
+tracking = "tracked"
+
+[kits.sdlc.local_metadata]
+conf_version = "1.0.0"
+
+[kits.sdlc.resources]
+[kits.sdlc.resources.adr_template]
+path = "config/kits/sdlc/artifacts/ADR/template.md"
+kind = "template"
+public = false
+description = "ADR artifact template"
+
+[kits.sdlc.resources.adr_rules]
+path = "config/kits/sdlc/artifacts/ADR/rules.md"
+kind = "other"
+public = false
+description = "ADR validation rules"
+
+[kits.sdlc.resources.adr_checklist]
+path = "config/kits/sdlc/artifacts/ADR/checklist.md"
+kind = "checklist"
+public = false
+description = "ADR review checklist"
+
+[kits.sdlc.resources.adr_example]
+path = "config/kits/sdlc/artifacts/ADR/examples/example.md"
+kind = "other"
+public = false
+description = "ADR example artifact"
+
+[kits.sdlc.resources.decomposition_template]
+path = "config/kits/sdlc/artifacts/DECOMPOSITION/template.md"
+kind = "template"
+public = false
+description = "DECOMPOSITION artifact template"
+
+[kits.sdlc.resources.decomposition_rules]
+path = "config/kits/sdlc/artifacts/DECOMPOSITION/rules.md"
+kind = "other"
+public = false
+description = "DECOMPOSITION validation rules"
+
+[kits.sdlc.resources.decomposition_checklist]
+path = "config/kits/sdlc/artifacts/DECOMPOSITION/checklist.md"
+kind = "checklist"
+public = false
+description = "DECOMPOSITION review checklist"
+
+[kits.sdlc.resources.decomposition_example]
+path = "config/kits/sdlc/artifacts/DECOMPOSITION/examples/example.md"
+kind = "other"
+public = false
+description = "DECOMPOSITION example artifact"
+
+[kits.sdlc.resources.design_template]
+path = "config/kits/sdlc/artifacts/DESIGN/template.md"
+kind = "template"
+public = false
+description = "DESIGN artifact template"
+
+[kits.sdlc.resources.design_rules]
+path = "config/kits/sdlc/artifacts/DESIGN/rules.md"
+kind = "other"
+public = false
+description = "DESIGN validation rules"
+
+[kits.sdlc.resources.design_checklist]
+path = "config/kits/sdlc/artifacts/DESIGN/checklist.md"
+kind = "checklist"
+public = false
+description = "DESIGN review checklist"
+
+[kits.sdlc.resources.design_example]
+path = "config/kits/sdlc/artifacts/DESIGN/examples/example.md"
+kind = "other"
+public = false
+description = "DESIGN example artifact"
+
+[kits.sdlc.resources.feature_template]
+path = "config/kits/sdlc/artifacts/FEATURE/template.md"
+kind = "template"
+public = false
+description = "FEATURE artifact template"
+
+[kits.sdlc.resources.feature_rules]
+path = "config/kits/sdlc/artifacts/FEATURE/rules.md"
+kind = "other"
+public = false
+description = "FEATURE validation rules"
+
+[kits.sdlc.resources.feature_checklist]
+path = "config/kits/sdlc/artifacts/FEATURE/checklist.md"
+kind = "checklist"
+public = false
+description = "FEATURE review checklist"
+
+[kits.sdlc.resources.feature_example]
+path = "config/kits/sdlc/artifacts/FEATURE/examples/example.md"
+kind = "other"
+public = false
+description = "FEATURE example artifact"
+
+[kits.sdlc.resources.prd_template]
+path = "config/kits/sdlc/artifacts/PRD/template.md"
+kind = "template"
+public = false
+description = "PRD artifact template"
+
+[kits.sdlc.resources.prd_rules]
+path = "config/kits/sdlc/artifacts/PRD/rules.md"
+kind = "other"
+public = false
+description = "PRD validation rules"
+
+[kits.sdlc.resources.prd_checklist]
+path = "config/kits/sdlc/artifacts/PRD/checklist.md"
+kind = "checklist"
+public = false
+description = "PRD review checklist"
+
+[kits.sdlc.resources.prd_example]
+path = "config/kits/sdlc/artifacts/PRD/examples/example.md"
+kind = "other"
+public = false
+description = "PRD example artifact"
+
+[kits.sdlc.resources.pr_code_review_template]
+path = "config/kits/sdlc/artifacts/PR-CODE-REVIEW-TEMPLATE/template.md"
+kind = "template"
+public = false
+description = "PR code review report template"
+
+[kits.sdlc.resources.pr_status_report_template]
+path = "config/kits/sdlc/artifacts/PR-STATUS-REPORT-TEMPLATE/template.md"
+kind = "template"
+public = false
+description = "PR status report template"
+
+[kits.sdlc.resources.codebase_rules]
+path = "config/kits/sdlc/codebase/rules.md"
+kind = "other"
+public = false
+description = "Codebase traceability and implementation rules"
+
+[kits.sdlc.resources.codebase_checklist]
+path = "config/kits/sdlc/codebase/checklist.md"
+kind = "checklist"
+public = false
+description = "Codebase review checklist"
+
+[kits.sdlc.resources.workflow_pr_review]
+path = "config/kits/sdlc/workflows/pr-review.md"
+kind = "skill"
+public = true
+description = "PR review workflow"
+user_modifiable = false
+generated_targets = ["installed"]
+origin = "legacy-workflow"
+
+[kits.sdlc.resources.workflow_pr_status]
+path = "config/kits/sdlc/workflows/pr-status.md"
+kind = "skill"
+public = true
+description = "PR status report workflow"
+user_modifiable = false
+generated_targets = ["installed"]
+origin = "legacy-workflow"
+
+[kits.sdlc.resources.workflow_migrate_openspec]
+path = "config/kits/sdlc/workflows/migrate-openspec.md"
+kind = "skill"
+public = true
+description = "OpenSpec to Constructor Studio SDLC migration workflow"
+user_modifiable = false
+generated_targets = ["installed"]
+origin = "legacy-workflow"
+
+[kits.sdlc.resources.workflow_doc_prd]
+path = "config/kits/sdlc/workflows/doc-prd.md"
+kind = "skill"
+public = true
+description = "PRD authoring preset workflow (wraps cf-write-docs)"
+user_modifiable = false
+generated_targets = ["installed"]
+origin = "legacy-workflow"
+
+[kits.sdlc.resources.workflow_doc_adr]
+path = "config/kits/sdlc/workflows/doc-adr.md"
+kind = "skill"
+public = true
+description = "ADR authoring preset workflow (wraps cf-write-docs)"
+user_modifiable = false
+generated_targets = ["installed"]
+origin = "legacy-workflow"
+
+[kits.sdlc.resources.workflow_doc_design]
+path = "config/kits/sdlc/workflows/doc-design.md"
+kind = "skill"
+public = true
+description = "DESIGN authoring preset workflow (wraps cf-write-docs)"
+user_modifiable = false
+generated_targets = ["installed"]
+origin = "legacy-workflow"
+
+[kits.sdlc.resources.workflow_decompose]
+path = "config/kits/sdlc/workflows/decompose.md"
+kind = "skill"
+public = true
+description = "DECOMPOSITION authoring preset workflow (wraps cf-write-docs)"
+user_modifiable = false
+generated_targets = ["installed"]
+origin = "legacy-workflow"
+
+[kits.sdlc.resources.workflow_doc_feature]
+path = "config/kits/sdlc/workflows/doc-feature.md"
+kind = "skill"
+public = true
+description = "FEATURE authoring preset workflow (wraps cf-write-docs)"
+user_modifiable = false
+generated_targets = ["installed"]
+origin = "legacy-workflow"
+
+[kits.sdlc.resources.workflow_implement]
+path = "config/kits/sdlc/workflows/implement.md"
+kind = "skill"
+public = true
+description = "CODE implementation preset workflow (wraps cf-coding)"
+user_modifiable = false
+generated_targets = ["installed"]
+origin = "legacy-workflow"
+
+[kits.sdlc.resources.workflow_change_impact_analysis]
+path = "config/kits/sdlc/workflows/change-impact-analysis.md"
+kind = "skill"
+public = true
+description = "Change impact analysis workflow (Phase-1; wraps cf-analyze)"
+user_modifiable = false
+generated_targets = ["installed"]
+origin = "legacy-workflow"
+
+[kits.sdlc.resources.workflow_reverse_engineer]
+path = "config/kits/sdlc/workflows/reverse-engineer.md"
+kind = "skill"
+public = true
+description = "Reverse-engineer artifacts from code workflow (Phase-1; wraps cf-write-docs)"
+user_modifiable = false
+generated_targets = ["installed"]
+origin = "legacy-workflow"
+
+[kits.sdlc.resources.change_impact_config]
+path = "config/kits/sdlc/scripts/change-impact-analysis.toml"
+kind = "script"
+public = false
+description = "Kit-owned thresholds for the change-impact-analysis workflow"
+
+[kits.sdlc.resources.scripts]
+path = "config/kits/sdlc/scripts"
+kind = "directory"
+public = false
+description = "Kit scripts and PR review prompts"
+
+[kits.sdlc.resources.constraints]
+path = "config/kits/sdlc/constraints.toml"
+kind = "constraints"
+public = false
+description = "Kit structural constraints (heading outlines, ID kinds, cross-references)"
+user_modifiable = false
+
+[kits.sdlc.resources.constraints.artifacts]
+[kits.sdlc.resources.constraints.artifacts.ADR]
+template = "adr_template"
+examples = "adr_example"
+
+[kits.sdlc.resources.constraints.artifacts.DECOMPOSITION]
+template = "decomposition_template"
+examples = "decomposition_example"
+
+[kits.sdlc.resources.constraints.artifacts.DESIGN]
+template = "design_template"
+examples = "design_example"
+
+[kits.sdlc.resources.constraints.artifacts.FEATURE]
+template = "feature_template"
+examples = "feature_example"
+
+[kits.sdlc.resources.constraints.artifacts.PRD]
+template = "prd_template"
+examples = "prd_example"
+
+[kits.sdlc.resources.agents]
+path = "config/kits/sdlc/AGENTS.md"
+kind = "rule"
+public = true
+description = "Kit AGENTS.md for agent integration entry points"
+user_modifiable = false
+generated_targets = ["installed"]

reference_audit-0.1.0/.cf-studio/config/kits/sdlc/AGENTS.md

@@ -0,0 +1,18 @@
+# Constructor Studio Kit: SDLC (`sdlc`)
+
+Agent quick reference.
+
+## What it is
+
+Artifact-first SDLC pipeline (PRD → ADR + DESIGN → DECOMPOSITION → FEATURE → CODE) with templates, checklists, examples, and per-artifact `rules.md` for deterministic validation + traceability.
+
+## Artifact kinds
+
+| Kind | Semantic intent (when to use) | References |
+| --- | --- | --- |
+| PRD | Product intent: actors + problems + FR/NFR + use cases + success criteria. | `{prd_rules}`, `{prd_template}`, `{prd_checklist}`, `{prd_example}` |
+| ADR | Decision log: why an architecture choice was made (context/options/decision/consequences). | `{adr_rules}`, `{adr_template}`, `{adr_checklist}`, `{adr_example}` |
+| DESIGN | System design: architecture, components, boundaries, interfaces, drivers, principles/constraints. | `{design_rules}`, `{design_template}`, `{design_checklist}`, `{design_example}` |
+| DECOMPOSITION | Executable plan: FEATURE list, ordering, dependencies, and coverage links back to PRD/DESIGN. | `{decomposition_rules}`, `{decomposition_template}`, `{decomposition_checklist}`, `{decomposition_example}` |
+| FEATURE | Precise behavior + DoD: CDSL flows/algos/states + test scenarios for implementability. | `{feature_rules}`, `{feature_template}`, `{feature_checklist}`, `{feature_example}` |
+| CODE | Implementation of FEATURE with optional `@cpt-*` markers and checkbox cascade/coverage validation. | `{codebase_rules}`, `{codebase_checklist}` |