Skip to content

questio phase 0: add result note type to notio + pixecog

Goal

Add a dedicated result note type to notio so that questio evidence records have their own directory, template, and index.

Context

The questio spec (section 4.4 and 9.2 of docs/specs/research-orchestration/design.md) defines a result note type for capturing structured evidence. Notio note types are declared in notio.toml — see packages/notio/notio.toml for existing types (idea, issue, task, meeting). Projects can add custom types via their own notio.toml or [tool.notio] in pyproject.toml.

The result note type needs structured frontmatter fields: question, milestone, metric, value, confidence, subjects, figure, series.

Prompt

Add a result note type to notio and configure it in pixecog.

Step 1: Read the notio default config at /storage2/arash/projects/projio/packages/notio/notio.toml to understand the note type definition format.

Step 2: Read the notio config loader at /storage2/arash/projects/projio/packages/notio/src/notio/config.py to understand how project-level configs merge with defaults.

Step 3: Read the questio spec section 5.3 and section 9.2 (notio integration) at /storage2/arash/projects/projio/docs/specs/research-orchestration/design.md for the result note schema.

Step 4: Add a result note type to notio's default notio.toml: 

[note_types.result]
mode = "event"
template = "result.md"
filename = "result-{owner}-{timestamp}"
toc_keys = ["question", "milestone", "metric", "confidence"]
toc_groupby = "series"

Step 5: Create the result note template at packages/notio/src/notio/templates/result.md. It should include frontmatter with all questio evidence fields: 

---
title: ""
tags: [result]
series: ""
question: []
milestone: ""
subjects: []
metric: ""
value: ""
figure: ""
confidence: preliminary
---

Step 6: In pixecog at /storage2/arash/projects/pixecog, create docs/log/result/ directory and add an index.md: 

# Results

Evidence records for research questions and milestones.

Step 7: Create one sample result note in pixecog to validate the template works: - Use note_create(type="result") if possible, or create manually - Title: "Sample result note — template validation" - Fill in placeholder values for all frontmatter fields

Step 8: Commit the notio changes in projio: "Add result note type to notio (questio evidence records)"

Step 9: Commit the pixecog changes: "Add result note directory and sample note"

Work across both repos: - notio package: /storage2/arash/projects/projio/packages/notio/ - pixecog: /storage2/arash/projects/pixecog/

Acceptance Criteria

  • [ ] result note type defined in notio.toml
  • [ ] Template file exists with all questio frontmatter fields
  • [ ] docs/log/result/index.md exists in pixecog
  • [ ] Sample result note validates the template
  • [ ] Both repos committed

Result

(Filled in after execution)

Batch Result

  • status: done
  • batch queue_id: f89dd756f3dc
  • session: e64cb29d-393c-4600-893b-02d62ca5ab92
  • batch duration: 356.5s