impyard 0.1.1

Rent the intelligence, own the governance — a control plane for imps: software colleagues whose every action passes through a gateway you control (default-deny egress, injected credentials, budgets, approval gates, audit).
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

//! `impyard imp init <name>` — scaffold a minimal imp spec.

use crate::paths;
use std::fs;

pub fn run(name: &str) -> Result<(), Box<dyn std::error::Error>> {
    let ok = !name.is_empty()
        && name
            .bytes()
            .all(|b| b.is_ascii_lowercase() || b.is_ascii_digit() || b == b'-')
        && name.as_bytes()[0] != b'-';
    if !ok {
        return Err(
            format!("imp name must be lowercase letters/numbers/hyphens: \"{name}\"").into(),
        );
    }

    let dir = paths::imp_dir(name);
    let path = dir.join("imp.toml");
    if path.exists() {
        return Err(format!("imp \"{name}\" already exists at {}", path.display()).into());
    }
    fs::create_dir_all(&dir)?;
    fs::write(
        &path,
        format!("# Imp spec — ADMIN-ONLY. Overlays org.toml at scope \"org/{name}\".\nname = \"{name}\"\n"),
    )?;

    // A deliberately minimal identity: a name, and the fact of being a digital
    // imp. Everything else is shaped later — by the admin editing this file,
    // or by the imp proposing changes (gated, D10). Operating principles
    // live in the runtime policy, not here.
    let identity = dir.join("identity.md");
    fs::write(
        &identity,
        format!(
            "# {name}\n\n\
             Your name is {name}. You're an imp — a colleague made of software,\n\
             not a human. That's all that's fixed about you. The rest of who you are\n\
             takes shape through the work you do and the people you do it with.\n"
        ),
    )?;

    println!("created {}", path.display());
    println!("created {}", identity.display());
    let knowledge_commit = crate::imp::knowledge::initialize(name).map_err(|error| {
        format!(
            "imp files were created, but its knowledge repository could not be initialized: {error}"
        )
    })?;
    println!("initialized knowledge at {knowledge_commit}");
    println!("edit them, then run: impyard server deploy");
    Ok(())
}