specfact-cli 0.47.11__tar.gz → 0.49.1__tar.gz

{specfact_cli-0.47.11 → specfact_cli-0.49.1}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: specfact-cli
-Version: 0.47.11
+Version: 0.49.1
 Summary: AI-bloat defense CLI for Python teams. Run deterministic code review, cleanup forecasts, and spec/contract evidence for AI-assisted and brownfield delivery.
 Project-URL: Homepage, https://github.com/nold-ai/specfact-cli
 Project-URL: Repository, https://github.com/nold-ai/specfact-cli.git

{specfact_cli-0.47.11 → specfact_cli-0.49.1}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "hatchling.build"
 
 [project]
 name = "specfact-cli"
-version = "0.47.11"
+version = "0.49.1"
 description = "AI-bloat defense CLI for Python teams. Run deterministic code review, cleanup forecasts, and spec/contract evidence for AI-assisted and brownfield delivery."
 readme = "README.md"
 requires-python = ">=3.11"

{specfact_cli-0.47.11 → specfact_cli-0.49.1}/resources/bundled-module-registry/index.json

@@ -1,10 +1,10 @@
 {
   "modules": [
     {
-      "checksum_sha256": "3a563335d7a5e16e6e9ec975d6e5c77ff550d8880474eca03713b43e97d39a4a",
-      "download_url": "https://github.com/nold-ai/specfact-cli/releases/download/init-0.1.37.tar.gz",
+      "checksum_sha256": "2ffe401e068883086f2df2beed8e9d328db9f0802deb3c69212b0594bfa1be75",
+      "download_url": "https://github.com/nold-ai/specfact-cli/releases/download/init-0.1.41.tar.gz",
       "id": "init",
-      "latest_version": "0.1.37"
+      "latest_version": "0.1.41"
     },
     {
       "checksum_sha256": "35c592374b209224af9a826c21efa66947cc16bf680b20ee0463f44bee4f9b59",

{specfact_cli-0.47.11 → specfact_cli-0.49.1}/src/__init__.py

@@ -3,4 +3,4 @@ SpecFact CLI - AI-bloat defense CLI for Python teams.
 """
 
 # Package version: keep in sync with pyproject.toml, setup.py, src/specfact_cli/__init__.py
-__version__ = "0.47.11"
+__version__ = "0.49.1"

{specfact_cli-0.47.11 → specfact_cli-0.49.1}/src/specfact_cli/__init__.py

@@ -76,6 +76,6 @@ def _install_progressive_disclosure() -> None:
 # keeps missing-command and missing-parameter UX consistent outside the root CLI too.
 _install_progressive_disclosure()
 
-__version__ = "0.47.11"
+__version__ = "0.49.1"
 
 __all__ = ["__version__"]

{specfact_cli-0.47.11 → specfact_cli-0.49.1}/src/specfact_cli/analyzers/code_analyzer.py

@@ -128,10 +128,11 @@ class CodeAnalyzer:
     def _resolve_analyzer_entry_point(repo_path: Path, entry_point: Path | None) -> Path | None:
         if entry_point is None:
             return None
-        resolved = entry_point if entry_point.is_absolute() else (repo_path / entry_point).resolve()
+        resolved_repo_path = repo_path.resolve()
+        resolved = entry_point.resolve() if entry_point.is_absolute() else (resolved_repo_path / entry_point).resolve()
         if not resolved.exists():
             raise ValueError(f"Entry point does not exist: {resolved}")
-        if not str(resolved).startswith(str(repo_path)):
+        if not resolved.is_relative_to(resolved_repo_path):
             raise ValueError(f"Entry point must be within repository: {resolved}")
         return resolved
 

{specfact_cli-0.47.11 → specfact_cli-0.49.1}/src/specfact_cli/models/__init__.py

@@ -37,6 +37,22 @@ from specfact_cli.models.project import (
     SectionLock,
 )
 from specfact_cli.models.protocol import Protocol, Transition
+from specfact_cli.models.requirements import (
+    REQUIREMENTS_INPUT_SCHEMA_VERSION,
+    BusinessRule,
+    RequirementCompletenessFinding,
+    RequirementCompletenessSeverity,
+    RequirementConstraint,
+    RequirementConstraintType,
+    RequirementEvidenceLink,
+    RequirementEvidenceLinkType,
+    RequirementInput,
+    RequirementsInputExtensionPayload,
+    RequirementSourceReference,
+    RequirementSourceType,
+    load_requirements_input_extension,
+    requirements_input_extension_payload,
+)
 from specfact_cli.models.sdd import (
     SDDCoverageThresholds,
     SDDEnforcementBudget,
@@ -49,6 +65,7 @@ from specfact_cli.models.source_tracking import SourceTracking
 
 
 __all__ = [
+    "REQUIREMENTS_INPUT_SCHEMA_VERSION",
     "AdapterType",
     "ArtifactMapping",
     "BridgeConfig",
@@ -57,6 +74,7 @@ __all__ = [
     "BundleManifest",
     "BundleVersions",
     "Business",
+    "BusinessRule",
     "ChangeArchive",
     "ChangeProposal",
     "ChangeTracking",
@@ -84,6 +102,16 @@ __all__ = [
     "Protocol",
     "ProtocolIndex",
     "Release",
+    "RequirementCompletenessFinding",
+    "RequirementCompletenessSeverity",
+    "RequirementConstraint",
+    "RequirementConstraintType",
+    "RequirementEvidenceLink",
+    "RequirementEvidenceLinkType",
+    "RequirementInput",
+    "RequirementSourceReference",
+    "RequirementSourceType",
+    "RequirementsInputExtensionPayload",
     "SDDCoverageThresholds",
     "SDDEnforcementBudget",
     "SDDHow",
@@ -100,4 +128,6 @@ __all__ = [
     "TemplateSection",
     "Transition",
     "ValidationReport",
+    "load_requirements_input_extension",
+    "requirements_input_extension_payload",
 ]

specfact_cli-0.49.1/src/specfact_cli/models/requirements.py

@@ -0,0 +1,183 @@
+"""Requirement evidence input models.
+
+These models normalize upstream requirement context for validation evidence.
+They do not make SpecFact the authoring system or source of truth for
+requirements.
+"""
+
+from __future__ import annotations
+
+from enum import StrEnum
+from typing import Any, Literal, cast
+
+from beartype import beartype
+from icontract import ensure, require
+from pydantic import BaseModel, ConfigDict, Field
+
+
+REQUIREMENTS_INPUT_SCHEMA_VERSION = "1"
+
+
+class RequirementSourceType(StrEnum):
+    """Supported upstream source reference types."""
+
+    ISSUE = "issue"
+    DOCUMENT = "document"
+    OPENSPEC_CHANGE = "openspec_change"
+    SPECKIT_SPEC = "speckit_spec"
+    FILE = "file"
+    BACKLOG_ITEM = "backlog_item"
+
+
+class RequirementEvidenceLinkType(StrEnum):
+    """Kinds of downstream evidence linked from a requirement input."""
+
+    ARCHITECTURE = "architecture"
+    SPEC = "spec"
+    CODE = "code"
+    TEST = "test"
+    VALIDATION = "validation"
+    REQUIREMENT = "requirement"
+
+
+class RequirementConstraintType(StrEnum):
+    """Supported requirement constraint categories."""
+
+    PERFORMANCE = "performance"
+    SECURITY = "security"
+    INTEGRATION = "integration"
+    COMPLIANCE = "compliance"
+    UX = "ux"
+    OPERATIONAL = "operational"
+
+
+class RequirementCompletenessSeverity(StrEnum):
+    """Advisory completeness finding severity."""
+
+    INFO = "info"
+    WARNING = "warning"
+    ERROR = "error"
+
+
+@beartype
+class RequirementSourceReference(BaseModel):
+    """Reference to an upstream requirement source."""
+
+    model_config = ConfigDict(use_enum_values=True)
+
+    source_type: RequirementSourceType = Field(..., description="Type of upstream requirement source")
+    locator: str = Field(..., min_length=1, description="Source locator such as URL, file path, or change ID")
+    title: str | None = Field(default=None, description="Human-readable source title")
+    revision: str | None = Field(default=None, description="Optional source revision, commit, or version")
+
+
+@beartype
+class BusinessRule(BaseModel):
+    """Business rule imported from upstream requirement context."""
+
+    rule_id: str = Field(..., min_length=1, description="Stable business rule identifier")
+    name: str = Field(..., min_length=1, description="Rule name")
+    given: str = Field(..., min_length=1, description="Given clause for validation scenario context")
+    when: str = Field(..., min_length=1, description="When clause for validation scenario context")
+    then: str = Field(..., min_length=1, description="Then clause for validation scenario context")
+    priority: str | None = Field(default=None, description="Optional upstream priority such as MoSCoW")
+
+
+@beartype
+class RequirementConstraint(BaseModel):
+    """Constraint imported from upstream requirement context."""
+
+    model_config = ConfigDict(use_enum_values=True)
+
+    constraint_id: str = Field(..., min_length=1, description="Stable constraint identifier")
+    constraint_type: RequirementConstraintType = Field(..., description="Constraint category")
+    statement: str = Field(..., min_length=1, description="Constraint statement")
+    validation_criteria: list[str] = Field(default_factory=list, description="Criteria used to validate constraint")
+
+
+@beartype
+class RequirementEvidenceLink(BaseModel):
+    """Link from requirement input to downstream validation evidence."""
+
+    model_config = ConfigDict(use_enum_values=True)
+
+    link_type: RequirementEvidenceLinkType = Field(..., description="Evidence target category")
+    target: str = Field(..., min_length=1, description="Evidence target locator")
+    relation: str = Field(default="references", min_length=1, description="Relationship to the target")
+
+
+@beartype
+class RequirementCompletenessFinding(BaseModel):
+    """Profile-aware completeness finding stored as advisory evidence."""
+
+    model_config = ConfigDict(use_enum_values=True)
+
+    profile: str = Field(..., min_length=1, description="Profile that produced this finding")
+    severity: RequirementCompletenessSeverity = Field(..., description="Finding severity")
+    field_path: str = Field(..., min_length=1, description="Requirement field path")
+    message: str = Field(..., min_length=1, description="Human-readable completeness guidance")
+
+
+@beartype
+class RequirementInput(BaseModel):
+    """Normalized requirement context consumed by validation evidence."""
+
+    schema_version: Literal["1"] = Field(..., description="Requirement input schema version")
+    requirement_id: str = Field(..., min_length=1, description="Stable requirement identifier")
+    title: str = Field(..., min_length=1, description="Requirement title")
+    summary: str | None = Field(default=None, description="Optional upstream requirement summary")
+    sources: list[RequirementSourceReference] = Field(
+        ...,
+        min_length=1,
+        description="Upstream requirement source references",
+    )
+    business_rules: list[BusinessRule] = Field(default_factory=list, description="Imported business rules")
+    constraints: list[RequirementConstraint] = Field(default_factory=list, description="Imported constraints")
+    evidence_links: list[RequirementEvidenceLink] = Field(default_factory=list, description="Evidence target links")
+    completeness_findings: list[RequirementCompletenessFinding] = Field(
+        default_factory=list,
+        description="Profile-aware advisory completeness findings",
+    )
+
+
+@beartype
+class RequirementsInputExtensionPayload(BaseModel):
+    """Serializable ProjectBundle extension payload for requirement inputs."""
+
+    schema_version: Literal["1"] = Field(..., description="Requirements extension payload schema version")
+    requirements: list[RequirementInput] = Field(default_factory=list, description="Requirement input records")
+
+
+def _payload_has_schema_version(result: dict[str, Any]) -> bool:
+    return result.get("schema_version") == REQUIREMENTS_INPUT_SCHEMA_VERSION
+
+
+def _payload_has_requirements_list(result: dict[str, Any]) -> bool:
+    return isinstance(result.get("requirements"), list)
+
+
+def _payload_is_valid_extension(payload: dict[str, Any]) -> bool:
+    try:
+        RequirementsInputExtensionPayload.model_validate(payload)
+    except ValueError:
+        return False
+    return True
+
+
+@beartype
+@require(lambda records: all(isinstance(record, RequirementInput) for record in records))
+@ensure(_payload_has_schema_version)
+@ensure(_payload_has_requirements_list)
+def requirements_input_extension_payload(records: list[RequirementInput]) -> dict[str, Any]:
+    """Return a JSON-serializable ProjectBundle extension payload."""
+    payload = RequirementsInputExtensionPayload(schema_version=REQUIREMENTS_INPUT_SCHEMA_VERSION, requirements=records)
+    return cast(dict[str, Any], payload.model_dump(mode="json"))
+
+
+@beartype
+@require(lambda payload: isinstance(payload, dict))
+@require(_payload_is_valid_extension)
+@ensure(lambda result: all(isinstance(record, RequirementInput) for record in result))
+def load_requirements_input_extension(payload: dict[str, Any]) -> list[RequirementInput]:
+    """Load requirement input records from a ProjectBundle extension payload."""
+    return RequirementsInputExtensionPayload.model_validate(payload).requirements

{specfact_cli-0.47.11 → specfact_cli-0.49.1}/src/specfact_cli/modules/init/module-package.yaml

@@ -1,5 +1,5 @@
 name: init
-version: 0.1.37
+version: 0.1.41
 commands:
   - init
 category: core
@@ -17,5 +17,5 @@ publisher:
 description: Initialize SpecFact workspace and bootstrap local configuration.
 license: Apache-2.0
 integrity:
-  checksum: sha256:8741e8fa3408bd38e7d65d0784a25466369955dd9f16f1981a52c0e1550afbe0
-  signature: kPAMdqpcAr92gr+DwxWibXfD0mgCLSb78EwGzoXH3fHct7xss8zt/SFvJLVZ0qkYHA8/4Nu6ls0iihRN9DXhCw==
+  checksum: sha256:7ad9c0b623f52a55b45f35adf9576bea1fd47edcd3005ed2354188a6a6ea20f5
+  signature: 7ED3ulYnu2VsJvPN/rEVLFHdVdBoiqJg1a8kR1FpWTmz9ZILrT/+NYq3CtnwGIvZscD/8CEBLBqKt1+0fCqZCQ==

{specfact_cli-0.47.11 → specfact_cli-0.49.1}/src/specfact_cli/modules/init/src/commands.py

@@ -48,14 +48,7 @@ from specfact_cli.utils.ide_setup import (
 )
 
 
-VALID_PROFILES: frozenset[str] = frozenset(
-    {
-        "solo-developer",
-        "backlog-team",
-        "api-first-team",
-        "enterprise-full-stack",
-    }
-)
+VALID_PROFILES: frozenset[str] = frozenset(first_run_selection.get_valid_profile_names())
 PROFILE_BUNDLES: dict[str, list[str]] = first_run_selection.PROFILE_PRESETS
 
 install_bundles_for_init = first_run_selection.install_bundles_for_init
@@ -709,6 +702,21 @@ def init_ide(
         console.print(f"[green]Updated VS Code settings:[/green] {settings_path}")
 
 
+def _write_profile_config_or_exit(repo_path: Path, profile: str) -> None:
+    try:
+        first_run_selection.write_profile_config(repo_path, profile)
+    except ValueError as e:
+        console.print(f"[red]Error:[/red] {e}")
+        raise typer.Exit(1) from e
+
+
+def _apply_explicit_profile_or_install(repo_path: Path, profile: str | None, install: str | None) -> list[str]:
+    enabled_module_ids = _apply_profile_or_install_bundles(profile, install)
+    if profile is not None:
+        _write_profile_config_or_exit(repo_path, profile)
+    return enabled_module_ids
+
+
 @app.callback(invoke_without_command=True)
 @require(lambda repo: _is_valid_repo_path(repo), "Repo path must exist and be directory")
 @ensure(lambda result: result is None, "Command should return None")
@@ -725,7 +733,10 @@ def init(
     profile: str | None = typer.Option(
         None,
         "--profile",
-        help="First-run profile preset: solo-developer, backlog-team, api-first-team, enterprise-full-stack",
+        help=(
+            "Validation tier or legacy workflow preset: solo, startup, mid_size, enterprise, "
+            "solo-developer, backlog-team, api-first-team, enterprise-full-stack"
+        ),
     ),
     install: str | None = typer.Option(
         None,
@@ -750,7 +761,7 @@ def init(
 
         enabled_module_ids: list[str] = []
         if profile is not None or install is not None:
-            enabled_module_ids = _apply_profile_or_install_bundles(profile, install)
+            enabled_module_ids = _apply_explicit_profile_or_install(repo_path, profile, install)
         elif is_first_run(user_root=INIT_USER_MODULES_ROOT) and is_non_interactive():
             console.print(
                 "[red]Error:[/red] In CI/CD (non-interactive) mode, first-run init requires "