@fractary/core 0.7.24 → 0.7.26

package/templates/docs/spec-infrastructure/template.md

@@ -0,0 +1,71 @@
+---
+title: "{{title}}"
+fractary_doc_type: spec-infrastructure
+status: {{status}}
+date: {{date}}
+{{#work_id}}
+work_id: "{{work_id}}"
+{{/work_id}}
+{{#work_type}}
+work_type: {{work_type}}
+{{/work_type}}
+source: {{source}}
+validation_status: not_validated
+tags: []
+---
+
+# {{title}}
+
+## Objective
+
+{{objective}}
+
+## Current State
+
+{{current_state}}
+
+## Proposed Changes
+
+{{#changes}}
+- [ ] {{.}}
+{{/changes}}
+
+## Security Considerations
+
+{{security_considerations}}
+
+{{#monitoring}}
+## Monitoring & Alerts
+
+{{monitoring}}
+{{/monitoring}}
+
+{{#capacity}}
+## Capacity Planning
+
+{{capacity}}
+{{/capacity}}
+
+{{#cost_impact}}
+## Cost Impact
+
+{{cost_impact}}
+{{/cost_impact}}
+
+## Rollback Plan
+
+{{rollback_plan}}
+
+## Verification
+
+{{#verification_steps}}
+- [ ] {{.}}
+{{/verification_steps}}
+
+{{#dependencies}}
+## Dependencies
+
+{{#dependencies}}
+- {{.}}
+{{/dependencies}}
+{{/dependencies}}

package/templates/docs/spec-infrastructure/type.yaml

@@ -0,0 +1,102 @@
+id: spec-infrastructure
+display_name: Infrastructure Specification
+description: Specification for infrastructure and DevOps changes
+
+output_path: specs
+
+file_naming:
+  pattern: "WORK-{work_id}-{slug}.md"
+  auto_number: false
+  slug_source: title
+  slug_max_length: 50
+
+frontmatter:
+  required_fields:
+    - title
+    - fractary_doc_type
+    - status
+    - date
+  optional_fields:
+    - work_id
+    - work_type
+    - source
+    - validation_status
+    - tags
+    - author
+    - related
+    - changelog
+  defaults:
+    fractary_doc_type: spec-infrastructure
+    status: draft
+    source: conversation
+    validation_status: not_validated
+
+structure:
+  required_sections:
+    - Objective
+    - Current State
+    - Proposed Changes
+    - Security Considerations
+    - Rollback Plan
+    - Verification
+  optional_sections:
+    - Monitoring & Alerts
+    - Capacity Planning
+    - Cost Impact
+    - Dependencies
+    - References
+  section_order:
+    - Objective
+    - Current State
+    - Proposed Changes
+    - Security Considerations
+    - Monitoring & Alerts
+    - Capacity Planning
+    - Cost Impact
+    - Rollback Plan
+    - Verification
+    - Dependencies
+    - References
+
+status:
+  allowed_values:
+    - draft
+    - review
+    - approved
+    - in-progress
+    - completed
+    - archived
+  default: draft
+
+index_config:
+  index_file: specs/README.md
+  sort_by: date
+  sort_order: desc
+  entry_template: "- [**{{work_id}}**: {{title}}]({{relative_path}}) — {{status}}"
+
+archive:
+  enabled: true
+  source: archive
+  trigger: on_status_change
+  trigger_statuses:
+    - archived
+  verify_checksum: true
+  delete_original: true
+
+work_linking:
+  enabled: true
+  comment_on_create: true
+  comment_on_archive: true
+  require_closed_for_archive: true
+
+refinement:
+  enabled: true
+  post_questions_to_work_item: true
+  maintain_changelog: true
+
+fulfillment:
+  enabled: true
+  check_acceptance_criteria: false
+  check_files_modified: true
+  check_tests_added: false
+  check_docs_updated: true

package/templates/docs/standards/standards.md

@@ -0,0 +1,15 @@
+# Standards Documentation Standards
+
+## Required Conventions
+
+- ALWAYS include clear scope
+- ALWAYS provide examples
+- ALWAYS document exceptions
+- ALWAYS explain enforcement
+
+## Best Practices
+
+- Include good and bad examples
+- Version standards documents
+- Track changes in changelog
+- Reference external standards

package/templates/docs/standards/template.md

@@ -0,0 +1,54 @@
+# {{title}}
+
+## Overview
+
+{{overview}}
+
+## Scope
+
+{{scope}}
+
+## Standards
+
+{{#standards}}
+### {{name}}
+
+{{description}}
+
+{{#rules}}
+#### {{title}}
+
+{{description}}
+
+{{#examples}}
+**{{type}}:**
+```{{language}}
+{{code}}
+```
+{{/examples}}
+
+{{/rules}}
+
+{{/standards}}
+
+## Exceptions
+
+{{#exceptions}}
+- **{{context}}**: {{description}}
+{{/exceptions}}
+
+## Enforcement
+
+{{enforcement}}
+
+## References
+
+{{#references}}
+- [{{title}}]({{url}})
+{{/references}}
+
+## Changelog
+
+{{#changelog}}
+- **{{date}}**: {{change}}
+{{/changelog}}

package/templates/docs/standards/type.yaml

@@ -0,0 +1,61 @@
+# Standards & Conventions Type Definition
+
+id: standards
+display_name: Standards & Conventions
+description: Coding standards, style guides, and team conventions
+
+output_path: docs/standards
+
+file_naming:
+  pattern: "STD-{slug}.md"
+  slug_source: title
+  slug_max_length: 50
+
+frontmatter:
+  required_fields:
+    - title
+    - type
+    - status
+    - date
+  optional_fields:
+    - owner
+    - applies_to
+    - tags
+    - related
+    - version
+  defaults:
+    type: standards
+    status: draft
+
+structure:
+  required_sections:
+    - Overview
+    - Standards
+  optional_sections:
+    - Scope
+    - Exceptions
+    - Enforcement
+    - References
+    - Changelog
+  section_order:
+    - Overview
+    - Scope
+    - Standards
+    - Exceptions
+    - Enforcement
+    - References
+    - Changelog
+
+status:
+  allowed_values:
+    - draft
+    - review
+    - approved
+    - deprecated
+  default: draft
+
+index_config:
+  index_file: docs/standards/README.md
+  sort_by: title
+  sort_order: asc
+  entry_template: "- [{{title}}]({{relative_path}}) - {{status}}"

package/templates/docs/testing/standards.md

@@ -0,0 +1,15 @@
+# Testing Documentation Standards
+
+## Required Conventions
+
+- ALWAYS define test scope
+- ALWAYS document test cases with steps
+- ALWAYS include expected results
+- ALWAYS track test status
+
+## Best Practices
+
+- Use unique test case IDs
+- Document test environment
+- Track issues found
+- Get sign-off for releases

package/templates/docs/testing/template.md

@@ -0,0 +1,87 @@
+# {{title}}
+
+## Overview
+
+{{overview}}
+
+## Test Scope
+
+### In Scope
+
+{{#in_scope}}
+- {{.}}
+{{/in_scope}}
+
+### Out of Scope
+
+{{#out_of_scope}}
+- {{.}}
+{{/out_of_scope}}
+
+## Test Environment
+
+{{environment}}
+
+## Test Cases
+
+{{#test_cases}}
+### {{id}}: {{title}}
+
+**Priority:** {{priority}}
+**Type:** {{type}}
+
+**Preconditions:**
+{{#preconditions}}
+- {{.}}
+{{/preconditions}}
+
+**Steps:**
+{{#steps}}
+1. {{.}}
+{{/steps}}
+
+**Expected Result:**
+{{expected_result}}
+
+**Status:** {{status}}
+
+{{/test_cases}}
+
+## Test Data
+
+{{test_data}}
+
+## Results Summary
+
+| Metric | Value |
+|--------|-------|
+| Total Tests | {{results.total}} |
+| Passed | {{results.passed}} |
+| Failed | {{results.failed}} |
+| Skipped | {{results.skipped}} |
+| Pass Rate | {{results.pass_rate}} |
+
+## Issues Found
+
+{{#issues}}
+### {{id}}: {{title}}
+
+**Severity:** {{severity}}
+**Status:** {{status}}
+
+{{description}}
+{{/issues}}
+
+## Recommendations
+
+{{#recommendations}}
+- {{.}}
+{{/recommendations}}
+
+## Sign-off
+
+| Role | Name | Date | Status |
+|------|------|------|--------|
+{{#signoffs}}
+| {{role}} | {{name}} | {{date}} | {{status}} |
+{{/signoffs}}

package/templates/docs/testing/type.yaml

@@ -0,0 +1,65 @@
+# Testing Documentation Type Definition
+
+id: testing
+display_name: Testing Documentation
+description: Test plans, test results, and QA documentation
+
+output_path: docs/testing
+
+file_naming:
+  pattern: "TEST-{slug}.md"
+  slug_source: title
+  slug_max_length: 50
+
+frontmatter:
+  required_fields:
+    - title
+    - type
+    - status
+    - date
+  optional_fields:
+    - tester
+    - version
+    - tags
+    - related
+    - test_type
+  defaults:
+    type: testing
+    status: draft
+
+structure:
+  required_sections:
+    - Overview
+    - Test Scope
+    - Test Cases
+    - Results Summary
+  optional_sections:
+    - Test Environment
+    - Test Data
+    - Issues Found
+    - Recommendations
+    - Sign-off
+  section_order:
+    - Overview
+    - Test Scope
+    - Test Environment
+    - Test Cases
+    - Test Data
+    - Results Summary
+    - Issues Found
+    - Recommendations
+    - Sign-off
+
+status:
+  allowed_values:
+    - draft
+    - in_progress
+    - completed
+    - signed_off
+  default: draft
+
+index_config:
+  index_file: docs/testing/README.md
+  sort_by: date
+  sort_order: desc
+  entry_template: "- [{{title}}]({{relative_path}}) - {{status}} ({{results.pass_rate}})"

package/templates/logs/audit/standards.md

@@ -0,0 +1,33 @@
+# Audit Log Standards
+
+## Required Conventions
+
+### 1. Immutability
+- NEVER modify existing audit log entries
+- ALWAYS create new entries for updates or corrections
+- ALWAYS preserve original timestamps
+
+### 2. Completeness
+- ALWAYS include user/actor who performed the action
+- ALWAYS include the action performed
+- ALWAYS include the resource affected
+- ALWAYS include timestamps in ISO 8601 format
+
+### 3. Classification
+- ALWAYS set appropriate audit_type (security, compliance, performance, access, change)
+- ALWAYS set severity level (info, warning, critical)
+- ALWAYS escalate critical events immediately
+
+### 4. Evidence
+- ALWAYS include supporting evidence for critical events
+- ALWAYS reference related logs or tickets
+- ALWAYS document the source of the event
+
+## Best Practices
+
+- Use unique audit_id format: `AUDIT-{timestamp}-{random}`
+- Include IP addresses and session info for access events
+- Link to related compliance requirements
+- Set appropriate retention based on severity (critical = forever)
+- Review audit logs periodically for patterns
+- Never log sensitive data (passwords, tokens) in plain text

package/templates/logs/audit/template.md

@@ -0,0 +1,65 @@
+---
+log_type: audit
+title: {{title}}
+audit_id: {{audit_id}}
+date: {{date}}
+status: {{status}}
+audit_type: {{audit_type}}
+severity: {{severity}}
+{{#user}}
+user: {{user}}
+{{/user}}
+{{#action}}
+action: {{action}}
+{{/action}}
+{{#resource}}
+resource: {{resource}}
+{{/resource}}
+{{#work_id}}
+work_id: {{work_id}}
+{{/work_id}}
+{{#tags}}
+tags:
+{{#tags}}
+  - {{.}}
+{{/tags}}
+{{/tags}}
+---
+
+# Audit: {{title}}
+
+## Event Details
+
+- **Type**: {{audit_type}}
+- **Severity**: {{severity}}
+{{#user}}
+- **User**: {{user}}
+{{/user}}
+{{#action}}
+- **Action**: {{action}}
+{{/action}}
+{{#resource}}
+- **Resource**: {{resource}}
+{{/resource}}
+
+## Context
+
+{{context}}
+
+{{#impact}}
+## Impact Assessment
+
+{{impact}}
+{{/impact}}
+
+{{#evidence}}
+## Evidence
+
+{{evidence}}
+{{/evidence}}
+
+{{#recommended_actions}}
+## Recommended Actions
+
+{{recommended_actions}}
+{{/recommended_actions}}

package/templates/logs/audit/type.yaml

@@ -0,0 +1,85 @@
+# Audit Log Type Definition
+#
+# This file defines the schema, frontmatter rules, and configuration
+# for audit and compliance log entries.
+
+id: audit
+display_name: Audit Log
+description: Security events, access logs, compliance tracking, change audits
+
+# Output configuration
+output_path: .fractary/logs/audit
+
+# File naming rules
+file_naming:
+  pattern: "{date}-{audit_id}.md"
+  date_format: "YYYYMMDD-HHmmss"
+  slug_source: audit_id
+  slug_max_length: 36
+
+# Frontmatter schema
+frontmatter:
+  required_fields:
+    - log_type
+    - title
+    - audit_id
+    - date
+    - status
+    - audit_type
+    - severity
+  optional_fields:
+    - user
+    - action
+    - resource
+    - work_id
+    - tags
+  defaults:
+    log_type: audit
+    status: active
+
+# Document structure
+structure:
+  required_sections:
+    - Event Details
+    - Context
+  optional_sections:
+    - Impact Assessment
+    - Evidence
+    - Recommended Actions
+  section_order:
+    - Event Details
+    - Context
+    - Impact Assessment
+    - Evidence
+    - Recommended Actions
+
+# Status workflow
+status:
+  allowed_values:
+    - active
+    - completed
+    - archived
+  default: active
+
+# Audit type classification
+audit_type:
+  allowed_values:
+    - security
+    - compliance
+    - performance
+    - access
+    - change
+  default: security
+
+# Severity levels
+severity:
+  allowed_values:
+    - info
+    - warning
+    - critical
+  default: info
+
+# Retention policy
+retention:
+  default_local_days: 90
+  default_cloud_days: forever

package/templates/logs/build/standards.md

@@ -0,0 +1,32 @@
+# Build Log Standards
+
+## Required Conventions
+
+### 1. Identification
+- ALWAYS include unique build_id
+- ALWAYS include commit SHA when building from git
+- ALWAYS include branch name
+
+### 2. Status Tracking
+- ALWAYS update status as build progresses (pending -> running -> success/failure)
+- ALWAYS include exit code on completion
+- ALWAYS record duration in seconds
+
+### 3. Output Capture
+- ALWAYS capture full build output
+- ALWAYS include error messages and stack traces on failure
+- ALWAYS preserve output formatting
+
+### 4. Artifacts
+- ALWAYS list artifacts with full paths
+- ALWAYS include artifact sizes when available
+- ALWAYS note if artifacts were uploaded to storage
+
+## Best Practices
+
+- Use unique build_id format: `BUILD-{timestamp}-{random}`
+- Truncate extremely long outputs with "[truncated]" marker
+- Link builds to related issues/PRs via work_id
+- Include environment variables that affect the build (sanitized)
+- Record memory and CPU usage if available
+- Archive build logs for successful production builds longer