Skip to content

Epic: Core Flow Spec Compliance #56

Open
Epic
0 of 5 issues completed
Open
Epic: Core Flow Spec Compliance#56
Epic
0 of 5 issues completed
Labels
cliCommand-line interface and toolsenhancementNew feature or requestoutputResult formatting and output generationparserMagic file parsing components and grammar
Milestone
v0.4.0 - API & UX Polish
@unclesp1d3r

Description

@unclesp1d3r
unclesp1d3r
opened on Feb 14, 2026

Summary

Close all gaps between the Core Flows specification and the actual implementation, ensuring the library and CLI behave exactly as documented.

Core Flows Spec

`docs/plan/phase_1_mvp/specs/Core_Flows__libmagic-rs_Phase_1_MVP.md`

Tracking

Flow Issue Gap
Flow 3 (Magic Discovery) #49 Error message missing actionable suggestions
Flow 5 (Advanced API) #45 Builder pattern not implemented
Flow 8 (JSON Output) #46 Metadata object missing from JSON
Flow 11 (Corrupted Files) #47 Parse warnings silently swallowed
Flow 12 (Timeout) #44 Returns error instead of partial results

Flows Already Passing

  • Flow 1 (CLI Single File) - fully implemented
  • Flow 2 (CLI Multiple Files) - fully implemented
  • Flow 4 (Library Simple Usage) - fully implemented
  • Flow 6 (Public Evaluation APIs) - fully implemented
  • Flow 7 (Error Communication) - mostly implemented
  • Flow 9 (Hierarchical Matching) - fully implemented
  • Flow 10 (Stdin Input) - fully implemented

Success Criteria

All 12 Core Flows work as specified with no deviations.

Metadata

Metadata

Assignees

No one assigned

    Labels

    cliCommand-line interface and toolsenhancementNew feature or requestoutputResult formatting and output generationparserMagic file parsing components and grammar

    Type

    Epic

    Projects

    No projects

    Milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions