@deimoscloud/coreai 0.1.0

package/eslint.config.js

@@ -0,0 +1,29 @@
+import eslint from '@eslint/js';
+import tseslint from 'typescript-eslint';
+import prettier from 'eslint-plugin-prettier/recommended';
+
+export default tseslint.config(
+  eslint.configs.recommended,
+  ...tseslint.configs.strict,
+  ...tseslint.configs.stylistic,
+  prettier,
+  {
+    languageOptions: {
+      parserOptions: {
+        project: true,
+        tsconfigRootDir: import.meta.dirname,
+      },
+    },
+    rules: {
+      '@typescript-eslint/no-unused-vars': [
+        'error',
+        { argsIgnorePattern: '^_', varsIgnorePattern: '^_' },
+      ],
+      '@typescript-eslint/consistent-type-imports': 'error',
+      '@typescript-eslint/no-import-type-side-effects': 'error',
+    },
+  },
+  {
+    ignores: ['dist/**', 'node_modules/**', '*.js'],
+  }
+);

package/jest.config.js

@@ -0,0 +1,22 @@
+/** @type {import('ts-jest').JestConfigWithTsJest} */
+export default {
+  preset: 'ts-jest/presets/default-esm',
+  testEnvironment: 'node',
+  roots: ['<rootDir>/src'],
+  testMatch: ['**/*.test.ts'],
+  moduleNameMapper: {
+    '^(\\.{1,2}/.*)\\.js$': '$1',
+  },
+  transform: {
+    '^.+\\.tsx?$': [
+      'ts-jest',
+      {
+        useESM: true,
+      },
+    ],
+  },
+  extensionsToTreatAsEsm: ['.ts'],
+  collectCoverageFrom: ['src/**/*.ts', '!src/**/*.test.ts', '!src/**/*.d.ts'],
+  coverageDirectory: 'coverage',
+  coverageReporters: ['text', 'lcov', 'html'],
+};

package/knowledge-library/README.md

@@ -0,0 +1,118 @@
+# Knowledge Library
+
+Shared context and agent communication hub for the development team.
+
+## Structure
+
+```
+knowledge-library/
+├── README.md              # This file
+├── context.txt            # Overall project state (EM updates)
+├── architecture.txt       # Architecture decisions (EM updates)
+├── prd.txt                # Product requirements (PM/EM updates)
+├── workflows.md           # Symlink or copy of ../WORKFLOWS.md
+│
+├── [agent-name]/          # Per-agent directories
+│   ├── inbox/             # Messages received from other agents
+│   │   └── processed/     # Completed messages (archived)
+│   ├── outbox/            # Copies of sent messages
+│   ├── context/           # Agent's current state
+│   │   └── current.txt    # Current context file
+│   ├── history/           # Archived context files
+│   ├── tech/              # Technical docs, specs, designs
+│   └── control/           # Objectives, decisions, dependencies
+│       ├── objectives.txt
+│       ├── decisions.txt
+│       └── dependencies.txt
+```
+
+## Shared Context Files
+
+### context.txt
+Overall project state updated by Engineering Manager:
+- Current sprint and priorities
+- Active work and blockers
+- Recent decisions
+- Team status
+
+### architecture.txt
+Technical architecture decisions:
+- System design
+- Technology choices
+- Data models
+- Integration patterns
+
+### prd.txt
+Product requirements:
+- Feature specifications
+- User stories
+- Acceptance criteria
+- Priorities
+
+## Agent Directories
+
+Each agent has their own directory for:
+
+| Directory | Purpose | Who Updates |
+|-----------|---------|-------------|
+| `inbox/` | Receive tasks and messages | Other agents write here |
+| `inbox/processed/` | Archive of completed messages | Owner moves here |
+| `outbox/` | Copies of sent messages | Owner writes here |
+| `context/current.txt` | Agent's current state | Owner updates |
+| `history/` | Archived context snapshots | Owner archives |
+| `tech/` | Technical docs, specs | Owner creates |
+| `control/` | Objectives, decisions | Owner maintains |
+
+## Message File Naming
+
+### Inbox (received)
+```
+YYYYMMDD_HHMM-[from-agent]-[topic].md
+Example: 20260105_1430-engineering-manager-SUR-70-assignment.md
+```
+
+### Inbox Processed (archived)
+```
+PROCESSED_YYYYMMDD_HHMM_[original-filename].md
+Example: PROCESSED_20260105_1600_20260105_1430-engineering-manager-SUR-70-assignment.md
+```
+
+### Outbox (sent copies)
+```
+YYYYMMDD_HHMM-to-[recipient]-[topic].md
+Example: 20260105_1430-to-wearos-engineer-SUR-70-assignment.md
+```
+
+## Usage Rules
+
+1. **Root files** (context.txt, architecture.txt, prd.txt) - Only EM updates
+2. **All agents read** root files at startup
+3. **All agents update** their own context before finishing
+4. **All agents send** completion summaries to EM inbox
+5. **Move processed messages** to `inbox/processed/` to prevent duplicate work
+
+## Permissions Matrix
+
+| Agent | Create Tickets | Update Root Files | Own Directory |
+|-------|:--------------:|:-----------------:|:-------------:|
+| engineering-manager | ✅ | ✅ | ✅ |
+| solutions-architect | ✅ | ❌ | ✅ |
+| security-engineer | ✅ | ❌ | ✅ |
+| qa-engineer | ✅ | ❌ | ✅ |
+| product-manager | ✅ | ✅ (prd.txt) | ✅ |
+| backend-engineer | ❌ | ❌ | ✅ |
+| android-engineer | ❌ | ❌ | ✅ |
+| wearos-engineer | ❌ | ❌ | ✅ |
+| devops-engineer | ❌ | ❌ | ✅ |
+
+## External Integration
+
+This Knowledge Library works alongside:
+- **Jira** - Primary ticket tracking (MCP access)
+- **Confluence** - Primary documentation (MCP access)
+- **GitHub** - Code and PRs (gh CLI)
+
+Local files serve as:
+- Async communication between agents
+- Fallback when external services unavailable
+- Context persistence between sessions

package/knowledge-library/android-engineer/context/current.txt

@@ -0,0 +1,42 @@
+# [Agent Name] - Current Context
+
+> **Last Updated:** [YYYY-MM-DD HH:MM]
+
+## Current Focus
+
+[What you're currently working on]
+
+## Active Tasks
+
+| Ticket | Status | Branch | PR |
+|--------|--------|--------|-----|
+| [KEY-XX] | [in-progress/pr-created/in-review] | [branch] | [#XX or -] |
+
+## Work in Progress
+
+### [KEY-XX] - [Title]
+- **Status:** [status]
+- **Branch:** [branch name]
+- **Progress:**
+  - [x] Completed item
+  - [ ] Pending item
+- **Blockers:** [None or description]
+
+## Pending Reviews
+
+| PR | Ticket | Requested By | Status |
+|----|--------|--------------|--------|
+| #XX | [KEY-XX] | [agent] | [pending/done] |
+
+## Technical Notes
+
+[Any technical context to remember]
+
+## Next Actions
+
+1. [ ] [Action 1]
+2. [ ] [Action 2]
+
+## Questions/Blockers
+
+- [Any questions for EM or other agents]

package/knowledge-library/android-engineer/control/decisions.txt

@@ -0,0 +1,9 @@
+# [Agent Name] - Decision Log
+
+Format: `[YYYY-MM-DD] Decision: [summary] | Rationale: [why]`
+
+---
+
+## Decisions
+
+[YYYY-MM-DD] Decision: [example] | Rationale: [example]

package/knowledge-library/android-engineer/control/dependencies.txt

@@ -0,0 +1,19 @@
+# [Agent Name] - Dependencies
+
+## Waiting On
+
+| Dependency | From | Ticket | Status |
+|------------|------|--------|--------|
+| [what you need] | [agent] | [KEY-XX] | [waiting/resolved] |
+
+## Providing To
+
+| Deliverable | To | Ticket | Status |
+|-------------|-----|--------|--------|
+| [what you're providing] | [agent] | [KEY-XX] | [pending/delivered] |
+
+## External Dependencies
+
+| Dependency | Type | Status |
+|------------|------|--------|
+| [e.g., API access] | [service/data/approval] | [status] |

package/knowledge-library/android-engineer/control/objectives.txt

@@ -0,0 +1,26 @@
+# [Agent Name] - Objectives
+
+## Primary Objectives
+
+1. [Primary objective based on role]
+2. [Primary objective based on role]
+
+## Current Sprint Objectives
+
+- [ ] [Objective 1]
+- [ ] [Objective 2]
+
+## Quality Standards
+
+- [ ] All code has tests
+- [ ] Lint checks pass
+- [ ] Static analysis passes
+- [ ] Acceptance criteria met
+
+## Workflow Responsibilities
+
+- Move ticket to "In Progress" when starting
+- Create branch with correct naming
+- Run quality checks before PR
+- Move ticket to "In Review" after PR
+- Send completion report to EM

package/knowledge-library/architecture.txt

@@ -0,0 +1,61 @@
+# Architecture Context
+
+> **Last Updated:** [YYYY-MM-DD HH:MM]
+> **Updated By:** engineering-manager (with solutions-architect input)
+
+## System Overview
+
+[High-level description of the system architecture]
+
+## Components
+
+### [Component 1]
+- **Purpose:** [description]
+- **Technology:** [tech stack]
+- **Owner:** [agent]
+
+### [Component 2]
+- **Purpose:** [description]
+- **Technology:** [tech stack]
+- **Owner:** [agent]
+
+## Technology Stack
+
+| Layer | Technology | Notes |
+|-------|------------|-------|
+| [Layer] | [Tech] | [Notes] |
+
+## Architecture Principles
+
+1. **[Principle 1]** - [description]
+2. **[Principle 2]** - [description]
+3. **[Principle 3]** - [description]
+
+## Key Decisions
+
+| Date | Decision | Status | ADR |
+|------|----------|--------|-----|
+| [YYYY-MM-DD] | [decision] | [Active/Superseded] | [link] |
+
+## Data Model
+
+### Core Entities
+- **[Entity 1]:** [description]
+- **[Entity 2]:** [description]
+
+## Integration Points
+
+| System | Integration Type | Owner |
+|--------|-----------------|-------|
+| [System] | [API/Event/etc] | [agent] |
+
+## Constraints
+
+- [Constraint 1]
+- [Constraint 2]
+
+## References
+
+- [Link to detailed architecture docs]
+- [Link to ADRs]
+- [Link to diagrams]

package/knowledge-library/backend-engineer/context/current.txt

@@ -0,0 +1,42 @@
+# [Agent Name] - Current Context
+
+> **Last Updated:** [YYYY-MM-DD HH:MM]
+
+## Current Focus
+
+[What you're currently working on]
+
+## Active Tasks
+
+| Ticket | Status | Branch | PR |
+|--------|--------|--------|-----|
+| [KEY-XX] | [in-progress/pr-created/in-review] | [branch] | [#XX or -] |
+
+## Work in Progress
+
+### [KEY-XX] - [Title]
+- **Status:** [status]
+- **Branch:** [branch name]
+- **Progress:**
+  - [x] Completed item
+  - [ ] Pending item
+- **Blockers:** [None or description]
+
+## Pending Reviews
+
+| PR | Ticket | Requested By | Status |
+|----|--------|--------------|--------|
+| #XX | [KEY-XX] | [agent] | [pending/done] |
+
+## Technical Notes
+
+[Any technical context to remember]
+
+## Next Actions
+
+1. [ ] [Action 1]
+2. [ ] [Action 2]
+
+## Questions/Blockers
+
+- [Any questions for EM or other agents]

package/knowledge-library/backend-engineer/control/decisions.txt

@@ -0,0 +1,9 @@
+# [Agent Name] - Decision Log
+
+Format: `[YYYY-MM-DD] Decision: [summary] | Rationale: [why]`
+
+---
+
+## Decisions
+
+[YYYY-MM-DD] Decision: [example] | Rationale: [example]

package/knowledge-library/backend-engineer/control/dependencies.txt

@@ -0,0 +1,19 @@
+# [Agent Name] - Dependencies
+
+## Waiting On
+
+| Dependency | From | Ticket | Status |
+|------------|------|--------|--------|
+| [what you need] | [agent] | [KEY-XX] | [waiting/resolved] |
+
+## Providing To
+
+| Deliverable | To | Ticket | Status |
+|-------------|-----|--------|--------|
+| [what you're providing] | [agent] | [KEY-XX] | [pending/delivered] |
+
+## External Dependencies
+
+| Dependency | Type | Status |
+|------------|------|--------|
+| [e.g., API access] | [service/data/approval] | [status] |

package/knowledge-library/backend-engineer/control/objectives.txt

@@ -0,0 +1,26 @@
+# [Agent Name] - Objectives
+
+## Primary Objectives
+
+1. [Primary objective based on role]
+2. [Primary objective based on role]
+
+## Current Sprint Objectives
+
+- [ ] [Objective 1]
+- [ ] [Objective 2]
+
+## Quality Standards
+
+- [ ] All code has tests
+- [ ] Lint checks pass
+- [ ] Static analysis passes
+- [ ] Acceptance criteria met
+
+## Workflow Responsibilities
+
+- Move ticket to "In Progress" when starting
+- Create branch with correct naming
+- Run quality checks before PR
+- Move ticket to "In Review" after PR
+- Send completion report to EM

package/knowledge-library/context.txt

@@ -0,0 +1,52 @@
+# Project Context
+
+> **Last Updated:** [YYYY-MM-DD HH:MM]
+> **Updated By:** engineering-manager
+
+## Current Sprint
+
+**Sprint:** [Sprint Name/Number]
+**Dates:** [Start] - [End]
+**Goal:** [Sprint goal]
+
+## Priorities
+
+1. [Priority 1]
+2. [Priority 2]
+3. [Priority 3]
+
+## Active Work
+
+| Ticket | Assignee | Status | Notes |
+|--------|----------|--------|-------|
+| [KEY-XX] | [agent] | [status] | [notes] |
+
+## Blockers
+
+| Ticket | Blocker | Owner | Action Needed |
+|--------|---------|-------|---------------|
+| [KEY-XX] | [description] | [who] | [action] |
+
+## Recent Decisions
+
+| Date | Decision | Rationale |
+|------|----------|-----------|
+| [YYYY-MM-DD] | [decision] | [why] |
+
+## Team Status
+
+| Agent | Current Task | Status |
+|-------|--------------|--------|
+| engineering-manager | Coordination | Available |
+| solutions-architect | - | Available |
+| security-engineer | - | Available |
+| backend-engineer | - | Available |
+| android-engineer | - | Available |
+| wearos-engineer | - | Available |
+| qa-engineer | - | Available |
+| devops-engineer | - | Available |
+| product-manager | - | Available |
+
+## Notes
+
+[Any additional context for the team]

package/knowledge-library/devops-engineer/context/current.txt

@@ -0,0 +1,42 @@
+# [Agent Name] - Current Context
+
+> **Last Updated:** [YYYY-MM-DD HH:MM]
+
+## Current Focus
+
+[What you're currently working on]
+
+## Active Tasks
+
+| Ticket | Status | Branch | PR |
+|--------|--------|--------|-----|
+| [KEY-XX] | [in-progress/pr-created/in-review] | [branch] | [#XX or -] |
+
+## Work in Progress
+
+### [KEY-XX] - [Title]
+- **Status:** [status]
+- **Branch:** [branch name]
+- **Progress:**
+  - [x] Completed item
+  - [ ] Pending item
+- **Blockers:** [None or description]
+
+## Pending Reviews
+
+| PR | Ticket | Requested By | Status |
+|----|--------|--------------|--------|
+| #XX | [KEY-XX] | [agent] | [pending/done] |
+
+## Technical Notes
+
+[Any technical context to remember]
+
+## Next Actions
+
+1. [ ] [Action 1]
+2. [ ] [Action 2]
+
+## Questions/Blockers
+
+- [Any questions for EM or other agents]

package/knowledge-library/devops-engineer/control/decisions.txt

@@ -0,0 +1,9 @@
+# [Agent Name] - Decision Log
+
+Format: `[YYYY-MM-DD] Decision: [summary] | Rationale: [why]`
+
+---
+
+## Decisions
+
+[YYYY-MM-DD] Decision: [example] | Rationale: [example]

package/knowledge-library/devops-engineer/control/dependencies.txt

@@ -0,0 +1,19 @@
+# [Agent Name] - Dependencies
+
+## Waiting On
+
+| Dependency | From | Ticket | Status |
+|------------|------|--------|--------|
+| [what you need] | [agent] | [KEY-XX] | [waiting/resolved] |
+
+## Providing To
+
+| Deliverable | To | Ticket | Status |
+|-------------|-----|--------|--------|
+| [what you're providing] | [agent] | [KEY-XX] | [pending/delivered] |
+
+## External Dependencies
+
+| Dependency | Type | Status |
+|------------|------|--------|
+| [e.g., API access] | [service/data/approval] | [status] |

package/knowledge-library/devops-engineer/control/objectives.txt

@@ -0,0 +1,26 @@
+# [Agent Name] - Objectives
+
+## Primary Objectives
+
+1. [Primary objective based on role]
+2. [Primary objective based on role]
+
+## Current Sprint Objectives
+
+- [ ] [Objective 1]
+- [ ] [Objective 2]
+
+## Quality Standards
+
+- [ ] All code has tests
+- [ ] Lint checks pass
+- [ ] Static analysis passes
+- [ ] Acceptance criteria met
+
+## Workflow Responsibilities
+
+- Move ticket to "In Progress" when starting
+- Create branch with correct naming
+- Run quality checks before PR
+- Move ticket to "In Review" after PR
+- Send completion report to EM

package/knowledge-library/engineering-manager/context/current.txt

@@ -0,0 +1,40 @@
+# Engineering Manager - Current Context
+
+> **Last Updated:** [YYYY-MM-DD HH:MM]
+
+## Current Focus
+
+[What you're currently working on]
+
+## Active Delegations
+
+| Ticket | Agent | Status | Last Update |
+|--------|-------|--------|-------------|
+| [KEY-XX] | [agent] | [delegated/in-progress/awaiting-review] | [date] |
+
+## Pending Validations
+
+| Ticket | Agent | Completion Report | Action Needed |
+|--------|-------|-------------------|---------------|
+| [KEY-XX] | [agent] | [received/pending] | [validate/assign-reviewer] |
+
+## Open Reviews
+
+| PR | Ticket | Reviewers | Status |
+|----|--------|-----------|--------|
+| #XX | [KEY-XX] | [agents] | [pending/approved/changes-requested] |
+
+## Blockers to Resolve
+
+| Issue | Affected | Action |
+|-------|----------|--------|
+| [description] | [tickets/agents] | [what to do] |
+
+## Next Actions
+
+1. [ ] [Action 1]
+2. [ ] [Action 2]
+
+## Notes
+
+[Any context to remember for next session]

package/knowledge-library/engineering-manager/control/decisions.txt

@@ -0,0 +1,9 @@
+# Engineering Manager - Decision Log
+
+Format: `[YYYY-MM-DD] Decision: [summary] | Rationale: [why]`
+
+---
+
+## Decisions
+
+[YYYY-MM-DD] Decision: [example] | Rationale: [example]