Skip to content

yihemichael-wwc/phase2

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

3 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

Phase 2

Thin, pack-driven entity processing system.

What this is

Phase 2 is a small, service-driven core for working with domain packs, entities, merges, enrichment, timeline summaries, maintenance checks, and search.

Layering

  • CLI: parses commands and renders output
  • Services: contain business flow
  • Repositories: read/write local stores
  • Models: stable objects
  • Packs: capability bundles

Installation

cd phase2
pip install -e ".[dev]"

Then verify the command is available:

phase2 --help

Quick start

phase2 pack list
phase2 search query --q "seafood importer" --limit 10
phase2 maintenance check

Global flags

These flags can be used before the subcommand:

  • --json
  • --quiet
  • --dry-run
  • --force
  • --pack
  • --entity-id

Example:

phase2 --json pack list

Main commands

Pack

  • pack register
  • pack enable
  • pack disable
  • pack list
  • pack inspect

Merge

  • merge view
  • merge plan
  • merge run
  • merge status

Enrich

  • enrich preview
  • enrich run
  • enrich inspect

Summary

  • summary preview
  • summary run

Maintenance

  • maintenance check
  • maintenance report

Search

  • search query
  • search explain
  • search rank
  • search reindex

Examples

Register a pack

phase2 pack register \
  --path ./packs/example \
  --name example \
  --version 1.0.0 \
  --enable

List packs

phase2 pack list
phase2 pack list --enabled-only

View merge candidates

phase2 merge view --entity-id ent-001

Build a merge plan

phase2 merge plan --source ent-a --target ent-b

Run enrichment

phase2 enrich run --entity-id ent-001

Generate a summary

phase2 summary run --entity-id ent-001

Run maintenance checks

phase2 maintenance check
phase2 maintenance report --check-id check-001

Search

phase2 search query --q "seafood importer" --limit 10
phase2 search explain --query "seafood importer" --entity-id ent-001
phase2 search rank --query "seafood importer" --candidate ent-001 --candidate ent-002
phase2 search reindex --entity-id ent-001

Notes

  • This repository currently uses simple JSON-backed local stores for the first working version
  • Real persistence can be swapped in later without changing the CLI contract
  • pytest -q passes
  • The current implementation is stable for its present scope

About

Phase 2 scaffold for pack-driven entity processing: CLI, services, repositories, docs, tests.

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors

Languages