ontoref/reflection/modes/new_project.ncl

91 lines
3.9 KiB
Plaintext
Raw Normal View History

2026-03-13 00:21:04 +00:00
let s = import "../schema.ncl" in
# Mode: new_project
# Creates a new project in the ecosystem with ontology, kogral, syntaxis, and NATS wiring.
#
# Required params (substituted in cmd via {param}):
# {project_name} — identifier used for kogral init and syntaxis project create
# {project_dir} — absolute path where the repository is created
# {ontoref_dir} — absolute path to the ontoref checkout (for ontology template)
{
id = "new_project",
trigger = "Initialize a new project in the ontoref ecosystem",
preconditions = [
"git is available in PATH",
"nickel is available in PATH",
"{project_dir} parent directory exists and is writable",
"kogral CLI available (optional — init_kogral continues on failure)",
"syntaxis CLI available (optional — create_syntaxis_project continues on failure)",
"nats CLI available (optional — configure_nats and publish_ecosystem_event continue on failure)",
"{ontoref_dir}/.ontology/ or templates/ontology/ exists",
],
steps = [
{
id = "init_repo",
action = "initialize_git_repository",
actor = 'Both,
cmd = "git -C {project_dir} init && git -C {project_dir} commit --allow-empty -m 'chore: initial commit'",
depends_on = [],
on_error = { strategy = 'Stop },
},
{
id = "copy_ontology_template",
action = "scaffold_ontology_directory",
actor = 'Agent,
cmd = "cp -r {ontoref_dir}/templates/ontology {project_dir}/.ontology",
depends_on = [{ step = "init_repo", kind = 'OnSuccess }],
on_error = { strategy = 'Stop },
note = "Copies core.ncl, state.ncl, gate.ncl stubs — project owner fills in axioms",
},
{
id = "init_kogral",
action = "initialize_kogral_graph",
actor = 'Agent,
cmd = "kogral init --name {project_name} --dir {project_dir}/.kogral",
depends_on = [{ step = "init_repo", kind = 'OnSuccess }],
on_error = { strategy = 'Continue },
note = "kogral is optional — ecosystem functions without it; execution continues on failure",
},
{
id = "create_syntaxis_project",
action = "register_project_in_syntaxis",
actor = 'Agent,
cmd = "syntaxis project create --name {project_name} --path {project_dir}",
depends_on = [{ step = "init_repo", kind = 'OnSuccess }],
on_error = { strategy = 'Continue },
note = "syntaxis is optional — execution continues on failure",
},
{
id = "configure_nats",
action = "create_nats_consumer_for_project",
actor = 'Agent,
cmd = "^nats stream add ECOSYSTEM --subjects 'ecosystem.{project_name}.>' --no-headers-only --defaults err> /dev/null",
depends_on = [{ step = "init_repo", kind = 'OnSuccess }],
on_error = { strategy = 'Continue },
note = "NATS stream creation is idempotent and optional",
},
{
id = "publish_ecosystem_event",
action = "announce_project_created",
actor = 'Agent,
cmd = "nats pub ecosystem.project.created '{\"project_name\": \"{project_name}\", \"project_dir\": \"{project_dir}\"}'",
depends_on = [
{ step = "copy_ontology_template", kind = 'OnSuccess },
{ step = "init_kogral", kind = 'Always },
{ step = "create_syntaxis_project", kind = 'Always },
{ step = "configure_nats", kind = 'Always },
],
on_error = { strategy = 'Continue },
note = "Final announcement — best-effort, does not block project creation",
},
],
postconditions = [
"{project_dir} is an initialized git repository",
"{project_dir}/.ontology/ contains core.ncl, state.ncl, gate.ncl from templates",
"ecosystem.project.created published to NATS (best-effort)",
],
} | (s.Mode String)