Files
marqdo/src/knowledge/learn.rs
T
cflmy 9331af78e2 release(2.8.0): 合入 CHANGELOG/README/发版说明/skills prove 任务;CI 链接指向 doc/releases
- CHANGELOG.md:v2.8.0 条目(中英双语);
- README.md:版本行 2.7.1→2.8.0 + 愿景第 6 条(知识可证明);
- doc/releases/v2.8.0.md:双语发版说明(亮点/用法/已知限制);
- skills/marqdo-dev/index.mq.md:新增 prove 任务(路径/目录模式/
  require_lean/json;参数用 + 行声明升参,check 与 narrative-ratio 通过);
- 设计文档 §12.5 标记已合入;发版链接统一指向 doc/releases/v2.8.0.md。
2026-11-18 10:29:26 +08:00

131 lines
3.0 KiB
Rust
Executable File

//! Knowledge compilation from agent episodes / failure writebacks.
use std::fs;
use std::path::Path;
use anyhow::Result;
use crate::knowledge::util::slugify;
#[derive(Debug, Clone)]
pub struct LearnInput {
pub task: String,
pub failed_approach: Option<String>,
pub failure: Option<String>,
pub correct_approach: Option<String>,
pub decision_title: Option<String>,
pub decision_body: Option<String>,
pub constraint_title: Option<String>,
pub constraint_body: Option<String>,
}
pub fn learn(out_dir: &Path, input: &LearnInput) -> Result<Vec<std::path::PathBuf>> {
let mut written = Vec::new();
if input.failed_approach.is_some() || input.failure.is_some() {
let dir = out_dir.join("knowledge/failures");
fs::create_dir_all(&dir)?;
let stem = slugify(&format!("fail-{}", &input.task));
let path = dir.join(format!("{stem}.md"));
let body = format!(
r#"---
type: Failure
task: {task}
status: resolved
generated:
by: marqdo/knowledge-learn
---
# Do not repeat: {task}
## Failed approach
{failed}
## Failure
{failure}
## Correct approach
{correct}
## Introduced by
agent episode learn
"#,
task = input.task,
failed = input.failed_approach.as_deref().unwrap_or("_unspecified_"),
failure = input.failure.as_deref().unwrap_or("_unspecified_"),
correct = input.correct_approach.as_deref().unwrap_or("_unspecified_"),
);
fs::write(&path, body)?;
written.push(path);
}
if let (Some(title), Some(body)) = (&input.decision_title, &input.decision_body) {
let dir = out_dir.join("knowledge/decisions");
fs::create_dir_all(&dir)?;
let stem = slugify(title);
let path = dir.join(format!("{stem}.md"));
let page = format!(
r#"---
type: Decision
title: {title}
status: accepted
generated:
by: marqdo/knowledge-learn
---
# {title}
## Decision
{body}
"#,
title = title,
body = body,
);
fs::write(&path, page)?;
written.push(path);
}
if let (Some(title), Some(body)) = (&input.constraint_title, &input.constraint_body) {
let dir = out_dir.join("knowledge/constraints");
fs::create_dir_all(&dir)?;
let stem = slugify(title);
let path = dir.join(format!("{stem}.md"));
let page = format!(
r#"---
type: Constraint
title: {title}
status: stable
generated:
by: marqdo/knowledge-learn
---
# {title}
{body}
"#,
title = title,
body = body,
);
fs::write(&path, page)?;
written.push(path);
}
// Episode receipt
let ep = out_dir.join("agent/episodes");
fs::create_dir_all(&ep)?;
let ep_path = ep.join(format!("{}.json", slugify(&input.task)));
let receipt = serde_json::json!({
"task": input.task,
"learned": written.iter().map(|p| p.display().to_string()).collect::<Vec<_>>(),
});
fs::write(&ep_path, serde_json::to_string_pretty(&receipt)?)?;
written.push(ep_path);
Ok(written)
}