keisei/KeiSeiKit-1.0
2
0
Fork 0
Code Issues Pull requests Projects Releases Packages Wiki Activity Actions
KeiSeiKit-1.0/_primitives/_rust/kei-task/atoms/create.md
Parfii-bot ae82bc6242 feat(stream-b): kei-task pilot — 3 atoms (create/search/add-dependency) 
Pilot refactor per locked substrate schema. kei-task migrated to atom
layout:

- atoms/<verb>.md — YAML frontmatter + human body for 3 verbs
- atoms/schemas/<verb>-{input,output}.json — JSON Schema draft-07
- src/atoms/<verb>.rs — typed Input/Output/Error + pub fn run()
- src/atoms/mod.rs — module registry
- Cargo.toml [package.metadata.keisei] — crate-level substrate data
- src/main.rs — dispatcher for 3 pilot commands via atoms::

Zero behaviour change: 7/7 integration tests pass before and after
(create_and_get, update_persists, cycle_detected, milestone_linking,
dependency_chain_traversal, task_graph_edges, search_finds_task).

main.rs still has 5 non-migrated subcommands (update, graph,
dependency-chain, milestone, link-milestone) — scope discipline, they
migrate in later passes. main.rs 120 → 132 LOC.

Stream B pilot reference — other crates follow this pattern in v0.24+.

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
2026-04-23 00:09:55 +08:00

1.9 KiB
Raw Blame History

atom kind version input output errors side_effects idempotent timeout_ms deprecated stability keywords related
kei-task::create command 0.1.0
schema required example
schemas/create-input.json
title
title priority
Fix auth bug high
schema example
schemas/create-output.json
id created_at
42 1714000000
code http_analog description
InvalidPriority 400 Priority must be one of: critical, high, medium, low
code http_analog description
InvalidTitle 400 Title must be non-empty
code http_analog description
StoreError 500 Underlying SQLite store failed to insert the task
op domain
write kei-task-db
false 5000 null stable
task
todo
create
dag
planning
kei-task::add-dependency
kei-task::search

kei-task::create

Creates a new task row in the kei-task SQLite DAG. Returns the inserted row id and the created_at unix timestamp. Also indexes title + description into the FTS table used by kei-task::search.

Example

kei-task create "Fix auth bug" --priority high --description "Token rotation fails on leap second"

Returns the new task id on stdout:

42

Programmatic callers (runtime invocation) receive:

{ "id": 42, "created_at": 1714000000 }

Gotchas

  • priority defaults to "medium" if omitted. Case sensitive — High returns InvalidPriority.
  • description defaults to empty string; blank descriptions are still indexed by FTS but yield no search hits until populated.
  • milestone_id in the input schema is reserved for future use; the current CLI does NOT accept it — link via kei-task link-milestone after creation.
  • Title uniqueness is NOT enforced at DB level; duplicate titles are allowed and will all be returned by kei-task::search.

Related