codescout 0.13.0

High-performance coding agent toolkit MCP server
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
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98

//! Kind-aware preview extractors for artifact_get.
//!
//! Each artifact kind (plan, spec, memory, ...) has its own preview shape.
//! Unknown kinds fall back to the `default` extractor. See
//! `docs/superpowers/specs/2026-04-20-artifact-get-preview-design.md`.

pub mod default;
pub mod headings;
pub mod memory;
pub mod plan;
pub mod spec;
pub mod summary;

use crate::librarian::catalog::artifact::ArtifactRow;
use crate::librarian::tools::ToolContext;
use serde_json::Value;

/// Compute a kind-specific preview for an artifact.
///
/// `body` is the markdown body with frontmatter already stripped.
/// Returns a tagged JSON object with at least a `"shape"` discriminator.
pub fn extract(kind: &str, row: &ArtifactRow, body: &str, ctx: &ToolContext) -> Value {
    match kind {
        "plan" => plan::extract(row, body),
        "spec" => spec::extract(row, body),
        "memory" => memory::extract(row, body, ctx),
        _ => default::extract(row, body),
    }
}

#[cfg(test)]
mod tests {
    use super::*;
    use crate::librarian::catalog::artifact::ArtifactRow;
    use crate::librarian::catalog::Catalog;
    use crate::librarian::workspace::WorkspaceConfig;
    use std::sync::Arc;

    fn mk_row(kind: &str) -> ArtifactRow {
        ArtifactRow {
            id: "x".into(),
            abs_path: std::path::PathBuf::from("/test/r/x.md"),
            kind: kind.into(),
            status: "draft".into(),
            title: None,
            owners: vec![],
            tags: vec![],
            topic: None,
            time_scope: None,
            source: None,
            created_at: 0,
            updated_at: 0,
            file_mtime: 0,
            file_sha256: String::new(),
            confidence: 1.0,
        }
    }

    fn mk_ctx() -> ToolContext {
        let cat = Catalog::open_in_memory().unwrap();
        ToolContext {
            catalog: Arc::new(parking_lot::Mutex::new(cat)),
            workspace: Arc::new(WorkspaceConfig {
                roots: vec![],
                ignore: vec![],
                rules: vec![],
                umbrellas: vec![],
            }),
            rules: Arc::new(vec![]),
            embedding: None,
            current_project: None,
        }
    }

    #[test]
    fn routes_plan_to_plan_extractor() {
        let v = extract("plan", &mk_row("plan"), "- [ ] a\n", &mk_ctx());
        assert_eq!(v["shape"], "plan");
    }

    #[test]
    fn routes_spec_to_spec_extractor() {
        let v = extract("spec", &mk_row("spec"), "# T\n\nx.\n", &mk_ctx());
        assert_eq!(v["shape"], "spec");
    }

    #[test]
    fn routes_memory_to_memory_extractor() {
        let v = extract("memory", &mk_row("memory"), "", &mk_ctx());
        assert_eq!(v["shape"], "memory");
    }

    #[test]
    fn unknown_kind_falls_back_to_default() {
        let v = extract("adr", &mk_row("adr"), "text\n", &mk_ctx());
        assert_eq!(v["shape"], "default");
    }
}