spec-driven-docs 0.8.1

Spec-driven documentation: current specs, immutable decision records, and executable gates kept coherent for people and coding agents.
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

//! `policy` subcommand: parse-shape.
//!
//! Holds the clap derive structs only. No I/O, no business logic.

use camino::Utf8PathBuf;

/// Bring an adopted specification into agreement with what the project
/// declared, on request and never on upgrade.
#[derive(Debug, clap::Args)]
pub struct PolicyArgs {
    /// The verb.
    #[command(subcommand)]
    pub verb: PolicyVerb,
}

/// The one verb, previewing by default.
#[derive(Debug, clap::Subcommand)]
pub enum PolicyVerb {
    /// Add the rule that authorizes an active declaration to the adopted
    /// specification that owns it, where the local specifications lack it.
    Reconcile(ReconcileArgs),
}

/// What the verb takes.
#[derive(Debug, clap::Args)]
pub struct ReconcileArgs {
    /// The instance to act on; absolute, or the working directory.
    #[arg(long, default_value = ".")]
    pub target: Utf8PathBuf,

    /// Write the change. Without it the verb prints every file, the rule
    /// it would add, and the exact text, and changes nothing.
    #[arg(long)]
    pub apply: bool,
}