memstead-cli 0.2.0

Command-line interface for Memstead — query and mutate typed entity graphs from the shell. Default build produces the full `memstead` binary (multi-mem, git-backed); `--no-default-features` builds the lean folder-only surface.
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73

//! `memstead pipeline migrate` — convert the legacy `scopes|projections|
//! ingests/` JSON folders at the workspace root into the four-primitive
//! workspace-store shape under `.memstead/` (Medium / Facet / Projection /
//! Ingest). The conversion core lives in `memstead_base::pipeline_migrate`;
//! this is the operator-facing surface.

use clap::{Args as ClapArgs, Subcommand};
use serde_json::json;

use crate::CliError;
use crate::output::{ExitKind, print_json, print_markdown};
use crate::setup::CliContext;

#[derive(ClapArgs, Debug)]
pub struct Args {
    #[command(subcommand)]
    pub command: PipelineCommand,
}

#[derive(Subcommand, Debug)]
pub enum PipelineCommand {
    /// Migrate the legacy `scopes|projections|ingests/` JSON folders at the
    /// workspace root into the four-primitive workspace-store shape under
    /// `.memstead/`. A legacy scope splits into a Medium (territory) and a
    /// Facet (engagement). Idempotent — re-running reproduces identical
    /// files. The legacy folders are left in place; remove them when ready.
    Migrate,
}

pub fn run(ctx: &CliContext, args: Args) -> anyhow::Result<()> {
    match args.command {
        PipelineCommand::Migrate => migrate(ctx),
    }
}

fn migrate(ctx: &CliContext) -> anyhow::Result<()> {
    let (_shape, root) = ctx.workspace_shape().ok_or_else(|| {
        CliError::new(
            ExitKind::Generic,
            "NO_WORKSPACE",
            "not inside a Memstead workspace (no `.memstead/workspace.toml` in any ancestor)"
                .to_string(),
        )
    })?;
    let configs = memstead_base::migrate_legacy_pipeline(&root).map_err(|e| {
        CliError::new(
            ExitKind::Generic,
            "PIPELINE_MIGRATE_FAILED",
            format!("pipeline migration failed: {e}"),
        )
        .with_details(json!({ "error": e.to_string() }))
    })?;
    if ctx.json {
        print_json(&json!({
            "ok": true,
            "mediums": configs.mediums.len(),
            "facets": configs.facets.len(),
            "projections": configs.projections.len(),
            "ingests": configs.ingests.len(),
        }))?;
    } else {
        print_markdown(&format!(
            "# Pipeline migrated\n\nWrote to `.memstead/`: {} medium(s), {} facet(s), \
             {} projection(s), {} ingest(s).\n\nThe legacy `scopes|projections|ingests/` \
             folders were left in place — remove them when ready.\n",
            configs.mediums.len(),
            configs.facets.len(),
            configs.projections.len(),
            configs.ingests.len(),
        ));
    }
    Ok(())
}