Skip to content

OpenSpec and Spec Kit Import Runtime for Requirement Evidence #168

Description

@djm81

Synchronized scope (2026-07-13, rescoped)

Modules-side runtime for import-first requirement evidence from native OpenSpec and Spec Kit artifacts. The previous optional Intent Trace metadata scope is retired. Core counterpart owns parsing, normalization, content hashing, and gate evaluation (nold-ai/specfact-cli#350); this module stays a thin command surface.

Modules-owned scope (this issue)

  • specfact requirements import --from-openspec [PATH] and --from-speckit [PATH], delegating to core evidence-adapter helpers via the existing lazy-load pattern.
  • Conservative auto-detection of conventional layouts (openspec/changes/, Spec Kit specs/) when the path is omitted; clear error naming expected layouts otherwise.
  • Gate findings (scenario-unverified, stale-import, source-missing, ambiguous-mapping, unsupported-source-schema) surfaced in requirements validate with CI-usable non-zero exit; gate-relevant counts in list/coverage.
  • Profile default fix: when --profile is omitted, resolve the effective profile from layered configuration (core helper) instead of the hardcoded startup default; explicit flag wins.
  • Preserve the core mapping of id, title, acceptance, and trace_links to the existing requirement evidence fields; render unsupported-profile-field as an advisory. Do not parse, hash, gate, or enrich upstream metadata in the module.
  • Surface core unsupported-source-schema unchanged and do not persist a partial import; the module does not perform provider-version detection or fallback parsing.
  • Read-only toward upstream artifact directories; --from-file and existing sidecar/merge semantics unchanged.

Out of scope

  • Parsing, hashing, or gate logic in the module (core-owned).
  • Backlog import/drift (requirements-03-backlog-sync, parked 2026-07-13).
  • Any writes into OpenSpec or Spec Kit directories.

OpenSpec change: openspec-01-intent-trace
Track: B — Upstream Context Adapters, order 2 (pulled forward 2026-07-13)
Core counterpart: nold-ai/specfact-cli#350
Depends on: requirements-02-module-commands runtime (shipped, archived 2026-07-13)

Metadata

Metadata

Assignees

No one assigned

    Labels

    change-proposalProposal for a new changeenhancementNew feature or requestopenspecopenspec changeprojectSpecfact project related topic

    Fields

    No fields configured for User Story.

    Projects

    Status
    Done

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions