@fractary/core 0.7.23 → 0.7.25

package/templates/logs/operational/type.yaml

@@ -0,0 +1,87 @@
+# Operational Log Type Definition
+#
+# This file defines the schema, frontmatter rules, and configuration
+# for operational and infrastructure log entries.
+
+id: operational
+display_name: Operational Log
+description: System events, service health, monitoring alerts, incident logs
+
+# Output configuration
+output_path: .fractary/logs/operational
+
+# File naming rules
+file_naming:
+  pattern: "{date}-{event_id}.md"
+  date_format: "YYYYMMDD-HHmmss"
+  slug_source: event_id
+  slug_max_length: 36
+
+# Frontmatter schema
+frontmatter:
+  required_fields:
+    - log_type
+    - title
+    - event_id
+    - date
+    - status
+    - service
+  optional_fields:
+    - severity
+    - category
+    - environment
+    - work_id
+    - tags
+  defaults:
+    log_type: operational
+    status: active
+
+# Document structure
+structure:
+  required_sections:
+    - Event Details
+    - Description
+  optional_sections:
+    - Impact
+    - Response Actions
+    - Resolution
+    - Follow-up
+  section_order:
+    - Event Details
+    - Description
+    - Impact
+    - Response Actions
+    - Resolution
+    - Follow-up
+
+# Status workflow
+status:
+  allowed_values:
+    - active
+    - investigating
+    - resolved
+    - archived
+  default: active
+
+# Severity levels
+severity:
+  allowed_values:
+    - info
+    - warning
+    - error
+    - critical
+  default: info
+
+# Category classification
+category:
+  allowed_values:
+    - health
+    - alert
+    - maintenance
+    - incident
+  default: health
+
+# Retention policy
+retention:
+  default_local_days: 30
+  default_cloud_days: 90

package/templates/logs/session/standards.md

@@ -0,0 +1,34 @@
+# Session Log Standards
+
+## Required Conventions
+
+### 1. Identification
+- ALWAYS generate UUID format session_id
+- ALWAYS include start timestamp
+- ALWAYS link to conversation_id when available
+
+### 2. Metadata Tracking
+- ALWAYS record model name
+- ALWAYS track token count
+- ALWAYS calculate duration on session stop
+
+### 3. Status Management
+- ALWAYS start sessions as active
+- ALWAYS mark stopped when capture ends
+- ALWAYS mark error if session fails
+
+### 4. Content Capture
+- ALWAYS capture conversation exchanges
+- ALWAYS include tool calls and results
+- ALWAYS summarize session outcomes
+
+## Best Practices
+
+- Use UUID format: `{uuid}` for session_id
+- Redact sensitive information (API keys, passwords)
+- Include repository and branch context
+- Link sessions to work items when applicable
+- Summarize key decisions made during session
+- Note follow-up actions identified
+- Archive sessions after 7 days locally
+- Keep cloud copies for historical reference

package/templates/logs/session/template.md

@@ -0,0 +1,81 @@
+---
+log_type: session
+title: {{title}}
+session_id: {{session_id}}
+date: {{date}}
+status: {{status}}
+{{#conversation_id}}
+conversation_id: {{conversation_id}}
+{{/conversation_id}}
+{{#repository}}
+repository: {{repository}}
+{{/repository}}
+{{#branch}}
+branch: {{branch}}
+{{/branch}}
+{{#model}}
+model: {{model}}
+{{/model}}
+{{#token_count}}
+token_count: {{token_count}}
+{{/token_count}}
+{{#duration_seconds}}
+duration_seconds: {{duration_seconds}}
+{{/duration_seconds}}
+{{#work_id}}
+work_id: {{work_id}}
+{{/work_id}}
+{{#tags}}
+tags:
+{{#tags}}
+  - {{.}}
+{{/tags}}
+{{/tags}}
+---
+
+# Session: {{title}}
+
+## Metadata
+
+- **Started**: {{date}}
+{{#model}}
+- **Model**: {{model}}
+{{/model}}
+{{#repository}}
+- **Repository**: {{repository}}
+{{/repository}}
+{{#branch}}
+- **Branch**: {{branch}}
+{{/branch}}
+{{#token_count}}
+- **Tokens**: {{token_count}}
+{{/token_count}}
+{{#duration_seconds}}
+- **Duration**: {{duration_seconds}}s
+{{/duration_seconds}}
+
+## Conversation
+
+{{conversation}}
+
+{{#summary}}
+## Summary
+
+{{summary}}
+{{/summary}}
+
+{{#decisions}}
+## Decisions
+
+{{#decisions}}
+- {{.}}
+{{/decisions}}
+{{/decisions}}
+
+{{#follow_ups}}
+## Follow-ups
+
+{{#follow_ups}}
+- {{.}}
+{{/follow_ups}}
+{{/follow_ups}}

package/templates/logs/session/type.yaml

@@ -0,0 +1,69 @@
+# Session Log Type Definition
+#
+# This file defines the schema, frontmatter rules, and configuration
+# for Claude Code session log entries.
+
+id: session
+display_name: Session Log
+description: Claude Code sessions, conversation tracking, token usage, interaction history
+
+# Output configuration
+output_path: .fractary/logs/sessions
+
+# File naming rules
+file_naming:
+  pattern: "{date}-{session_id}.md"
+  date_format: "YYYYMMDD-HHmmss"
+  slug_source: session_id
+  slug_max_length: 36
+
+# Frontmatter schema
+frontmatter:
+  required_fields:
+    - log_type
+    - title
+    - session_id
+    - date
+    - status
+  optional_fields:
+    - conversation_id
+    - repository
+    - branch
+    - model
+    - token_count
+    - duration_seconds
+    - work_id
+    - tags
+  defaults:
+    log_type: session
+    status: active
+
+# Document structure
+structure:
+  required_sections:
+    - Metadata
+    - Conversation
+  optional_sections:
+    - Summary
+    - Decisions
+    - Follow-ups
+  section_order:
+    - Metadata
+    - Conversation
+    - Summary
+    - Decisions
+    - Follow-ups
+
+# Status workflow
+status:
+  allowed_values:
+    - active
+    - stopped
+    - archived
+    - error
+  default: active
+
+# Retention policy
+retention:
+  default_local_days: 7
+  default_cloud_days: forever

package/templates/logs/test/standards.md

@@ -0,0 +1,34 @@
+# Test Log Standards
+
+## Required Conventions
+
+### 1. Identification
+- ALWAYS include unique test_id
+- ALWAYS specify test type (unit, integration, e2e, performance)
+- ALWAYS include test framework name
+
+### 2. Results Tracking
+- ALWAYS include pass/fail/skip counts
+- ALWAYS set status based on results (passed if all pass, failed if any fail)
+- ALWAYS include coverage percentage when available
+
+### 3. Failure Documentation
+- ALWAYS include error messages for failures
+- ALWAYS include stack traces when available
+- ALWAYS include test name that failed
+
+### 4. Output Capture
+- ALWAYS capture test runner output
+- ALWAYS preserve output formatting
+- ALWAYS truncate excessively long output with marker
+
+## Best Practices
+
+- Use unique test_id format: `TEST-{timestamp}-{random}`
+- Link test runs to CI/CD pipelines
+- Include environment information (Node version, etc.)
+- Track test flakiness over time
+- Keep failed test logs longer than passing
+- Archive test logs based on test type (e2e longer than unit)
+- Include screenshots for e2e test failures
+- Document known flaky tests

package/templates/logs/test/template.md

@@ -0,0 +1,83 @@
+---
+log_type: test
+title: {{title}}
+test_id: {{test_id}}
+date: {{date}}
+status: {{status}}
+{{#test_type}}
+test_type: {{test_type}}
+{{/test_type}}
+{{#test_framework}}
+test_framework: {{test_framework}}
+{{/test_framework}}
+{{#pass_count}}
+pass_count: {{pass_count}}
+{{/pass_count}}
+{{#fail_count}}
+fail_count: {{fail_count}}
+{{/fail_count}}
+{{#skip_count}}
+skip_count: {{skip_count}}
+{{/skip_count}}
+{{#coverage_percent}}
+coverage_percent: {{coverage_percent}}
+{{/coverage_percent}}
+{{#duration_seconds}}
+duration_seconds: {{duration_seconds}}
+{{/duration_seconds}}
+{{#work_id}}
+work_id: {{work_id}}
+{{/work_id}}
+{{#tags}}
+tags:
+{{#tags}}
+  - {{.}}
+{{/tags}}
+{{/tags}}
+---
+
+# Test Run: {{title}}
+
+## Summary
+
+- **Total**: {{total_count}}
+{{#pass_count}}
+- **Passed**: {{pass_count}}
+{{/pass_count}}
+{{#fail_count}}
+- **Failed**: {{fail_count}}
+{{/fail_count}}
+{{#skip_count}}
+- **Skipped**: {{skip_count}}
+{{/skip_count}}
+{{#coverage_percent}}
+- **Coverage**: {{coverage_percent}}%
+{{/coverage_percent}}
+{{#duration_seconds}}
+- **Duration**: {{duration_seconds}}s
+{{/duration_seconds}}
+
+{{#failures}}
+## Failures
+
+{{#failures}}
+### {{name}}
+
+- **Error**: {{error}}
+{{#stack}}
+- **Stack**:
+```
+{{stack}}
+```
+{{/stack}}
+
+{{/failures}}
+{{/failures}}
+
+{{#output}}
+## Output
+
+```
+{{output}}
+```
+{{/output}}

package/templates/logs/test/type.yaml

@@ -0,0 +1,75 @@
+# Test Log Type Definition
+#
+# This file defines the schema, frontmatter rules, and configuration
+# for test execution log entries.
+
+id: test
+display_name: Test Log
+description: Test runs, QA results, test failures, coverage reports, CI test output
+
+# Output configuration
+output_path: .fractary/logs/test
+
+# File naming rules
+file_naming:
+  pattern: "{date}-{test_id}.md"
+  date_format: "YYYYMMDD-HHmmss"
+  slug_source: test_id
+  slug_max_length: 36
+
+# Frontmatter schema
+frontmatter:
+  required_fields:
+    - log_type
+    - title
+    - test_id
+    - date
+    - status
+  optional_fields:
+    - test_type
+    - test_framework
+    - pass_count
+    - fail_count
+    - skip_count
+    - coverage_percent
+    - duration_seconds
+    - work_id
+    - tags
+  defaults:
+    log_type: test
+    status: running
+
+# Document structure
+structure:
+  required_sections:
+    - Summary
+  optional_sections:
+    - Failures
+    - Output
+  section_order:
+    - Summary
+    - Failures
+    - Output
+
+# Status workflow
+status:
+  allowed_values:
+    - running
+    - passed
+    - failed
+    - skipped
+  default: running
+
+# Test type classification
+test_type:
+  allowed_values:
+    - unit
+    - integration
+    - e2e
+    - performance
+  default: unit
+
+# Retention policy
+retention:
+  default_local_days: 7
+  default_cloud_days: 14

package/templates/logs/workflow/standards.md

@@ -0,0 +1,35 @@
+# Workflow Log Standards
+
+## Required Conventions
+
+### 1. Identification
+- ALWAYS use workflow-{id} format for workflow_id
+- ALWAYS specify workflow type (faber, etl, cicd, data-pipeline, custom)
+- ALWAYS link to work item when applicable
+
+### 2. Phase Tracking
+- ALWAYS track current FABER phase for faber workflows
+- ALWAYS record phase transitions
+- ALWAYS timestamp all operations
+
+### 3. Operation Logging
+- ALWAYS log operations with timestamps
+- ALWAYS include operation duration
+- ALWAYS track operation status
+
+### 4. Decision Documentation
+- ALWAYS document key decisions
+- ALWAYS include decision rationale
+- ALWAYS note alternatives considered
+
+## Best Practices
+
+- Use unique workflow_id format: `workflow-{timestamp}-{random}`
+- Track dependencies between workflows
+- Include context (project, repo, branch)
+- Record all artifacts created
+- Calculate and display metrics
+- Document next steps for continuation
+- Link related workflow logs
+- Archive completed workflows with metrics summary
+- Use partial status for workflows that partially succeed

package/templates/logs/workflow/template.md

@@ -0,0 +1,95 @@
+---
+log_type: workflow
+title: {{title}}
+workflow_id: {{workflow_id}}
+timestamp: {{timestamp}}
+status: {{status}}
+{{#work_item_id}}
+work_item_id: {{work_item_id}}
+{{/work_item_id}}
+{{#phase}}
+phase: {{phase}}
+{{/phase}}
+{{#workflow_type}}
+workflow_type: {{workflow_type}}
+{{/workflow_type}}
+{{#context}}
+context:
+{{#context.project}}
+  project: {{context.project}}
+{{/context.project}}
+{{#context.repository}}
+  repository: {{context.repository}}
+{{/context.repository}}
+{{#context.branch}}
+  branch: {{context.branch}}
+{{/context.branch}}
+{{/context}}
+{{#work_id}}
+work_id: {{work_id}}
+{{/work_id}}
+{{#tags}}
+tags:
+{{#tags}}
+  - {{.}}
+{{/tags}}
+{{/tags}}
+---
+
+# Workflow: {{title}}
+
+{{#phase}}
+## Current Phase: {{phase}}
+{{/phase}}
+
+## Operations
+
+| Timestamp | Phase | Operation | Status | Duration |
+|-----------|-------|-----------|--------|----------|
+{{#operations}}
+| {{timestamp}} | {{phase}} | {{operation}} | {{status}} | {{duration}}ms |
+{{/operations}}
+
+{{#decisions}}
+## Decisions
+
+{{#decisions}}
+### {{title}}
+
+- **Rationale**: {{rationale}}
+{{#alternatives}}
+- **Alternatives**: {{alternatives}}
+{{/alternatives}}
+
+{{/decisions}}
+{{/decisions}}
+
+{{#artifacts}}
+## Artifacts
+
+{{#artifacts}}
+- {{.}}
+{{/artifacts}}
+{{/artifacts}}
+
+{{#metrics}}
+## Metrics
+
+{{#total_duration}}
+- **Duration**: {{total_duration}}
+{{/total_duration}}
+{{#operation_count}}
+- **Operations**: {{operation_count}}
+{{/operation_count}}
+{{#success_rate}}
+- **Success Rate**: {{success_rate}}%
+{{/success_rate}}
+{{/metrics}}
+
+{{#next_steps}}
+## Next Steps
+
+{{#next_steps}}
+- {{.}}
+{{/next_steps}}
+{{/next_steps}}

package/templates/logs/workflow/type.yaml

@@ -0,0 +1,91 @@
+# Workflow Log Type Definition
+#
+# This file defines the schema, frontmatter rules, and configuration
+# for workflow execution log entries.
+
+id: workflow
+display_name: Workflow Log
+description: FABER phases, ETL pipelines, data workflows, automation steps
+
+# Output configuration
+output_path: .fractary/logs/workflow
+
+# File naming rules
+file_naming:
+  pattern: "{date}-{workflow_id}.md"
+  date_format: "YYYYMMDD-HHmmss"
+  slug_source: workflow_id
+  slug_max_length: 36
+
+# Frontmatter schema
+frontmatter:
+  required_fields:
+    - log_type
+    - title
+    - workflow_id
+    - timestamp
+    - status
+  optional_fields:
+    - work_item_id
+    - phase
+    - workflow_type
+    - context
+    - work_id
+    - tags
+  defaults:
+    log_type: workflow
+    status: pending
+
+# Document structure
+structure:
+  required_sections:
+    - Operations
+  optional_sections:
+    - Current Phase
+    - Decisions
+    - Artifacts
+    - Metrics
+    - Next Steps
+  section_order:
+    - Current Phase
+    - Operations
+    - Decisions
+    - Artifacts
+    - Metrics
+    - Next Steps
+
+# Status workflow
+status:
+  allowed_values:
+    - pending
+    - running
+    - success
+    - failure
+    - partial
+    - cancelled
+  default: pending
+
+# FABER phase classification
+phase:
+  allowed_values:
+    - Frame
+    - Architect
+    - Build
+    - Evaluate
+    - Release
+  default: Frame
+
+# Workflow type classification
+workflow_type:
+  allowed_values:
+    - faber
+    - etl
+    - cicd
+    - data-pipeline
+    - custom
+  default: faber
+
+# Retention policy
+retention:
+  default_local_days: 30
+  default_cloud_days: 90