@thebackstoryis/engineering-with-ai 0.2.9

package/config/security-scan-response.schema.json

@@ -0,0 +1,52 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://engineeringwithai.dev/schemas/security-scan-response.schema.json",
+  "title": "EWAI security scan response",
+  "type": "object",
+  "additionalProperties": false,
+  "required": ["schema", "runId", "status", "complete", "capabilities", "findings"],
+  "properties": {
+    "schema": { "const": "ewai.security-scan-response/v1" },
+    "runId": { "type": "string", "minLength": 1, "maxLength": 80 },
+    "status": { "enum": ["complete", "incomplete", "failed"] },
+    "complete": { "type": "boolean" },
+    "capabilities": { "type": "array", "minItems": 1, "maxItems": 5, "uniqueItems": true, "items": { "$ref": "#/$defs/capability" } },
+    "findings": {
+      "type": "array",
+      "maxItems": 10000,
+      "items": {
+        "type": "object",
+        "additionalProperties": false,
+        "required": ["id", "capability", "summary"],
+        "properties": {
+          "id": { "type": "string", "minLength": 1, "maxLength": 160 },
+          "capability": { "$ref": "#/$defs/capability" },
+          "severity": { "enum": ["critical", "high", "medium", "low", "info", "unknown"] },
+          "confidence": { "type": "number", "minimum": 0, "maximum": 1 },
+          "summary": { "type": "string", "minLength": 1, "maxLength": 1000 },
+          "locations": { "$ref": "#/$defs/references" },
+          "remediation": { "type": "string", "maxLength": 2000 },
+          "evidence": { "$ref": "#/$defs/references" }
+        }
+      }
+    },
+    "tool": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["name", "version"],
+      "properties": {
+        "name": { "type": "string", "minLength": 1, "maxLength": 120 },
+        "version": { "type": "string", "minLength": 1, "maxLength": 80 }
+      }
+    },
+    "warnings": { "type": "array", "maxItems": 1000, "items": { "type": "string", "minLength": 1, "maxLength": 500 } }
+  },
+  "$defs": {
+    "capability": { "enum": ["source-static", "dependency-sbom", "secret-detection", "infrastructure-configuration", "llm-runtime-red-team"] },
+    "references": {
+      "type": "array",
+      "maxItems": 100,
+      "items": { "type": "string", "minLength": 1, "maxLength": 500 }
+    }
+  }
+}

package/config/security-validation-policy.schema.json

@@ -0,0 +1,74 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://engineeringwithai.dev/schemas/security-validation-policy.schema.json",
+  "title": "EWAI security validation policy",
+  "type": "object",
+  "additionalProperties": false,
+  "required": ["enabled"],
+  "allOf": [
+    {
+      "if": { "properties": { "enabled": { "const": true } } },
+      "then": { "required": ["profiles"] }
+    }
+  ],
+  "properties": {
+    "enabled": { "type": "boolean" },
+    "profiles": {
+      "type": "array",
+      "minItems": 1,
+      "items": {
+        "type": "object",
+        "additionalProperties": false,
+        "required": ["id", "capability", "required", "freshness_hours", "accountable_role"],
+        "properties": {
+          "id": { "type": "string", "pattern": "^[a-z][a-z0-9-]{1,63}$" },
+          "capability": { "enum": ["source-static", "dependency-sbom", "secret-detection", "infrastructure-configuration", "llm-runtime-red-team"] },
+          "required": { "type": "boolean" },
+          "freshness_hours": { "type": "integer", "minimum": 1, "maximum": 8760 },
+          "timeout_seconds": { "type": "integer", "minimum": 1, "maximum": 3600 },
+          "accountable_role": { "type": "string", "minLength": 1, "maxLength": 120 },
+          "modes": { "type": "array", "minItems": 1, "uniqueItems": true, "items": { "enum": ["command", "skill", "artifact-import"] } },
+          "provider": { "enum": ["agentic-security", "deepsec", "visa-vvah"] },
+          "adapter": { "type": "string", "pattern": "^[a-z][a-z0-9.-]{1,79}$" },
+          "checkpoint": { "type": "string", "minLength": 1, "maxLength": 80 },
+          "thresholds": {
+            "type": "object",
+            "additionalProperties": false,
+            "properties": {
+              "blocking_severities": {
+                "type": "array",
+                "minItems": 1,
+                "maxItems": 6,
+                "uniqueItems": true,
+                "items": { "enum": ["critical", "high", "medium", "low", "info", "unknown"] }
+              }
+            }
+          },
+          "scope": {
+            "type": "object",
+            "additionalProperties": false,
+            "properties": {
+              "include": { "$ref": "#/$defs/projectPaths" },
+              "exclude": { "$ref": "#/$defs/projectPaths" }
+            }
+          },
+          "target_class": { "enum": ["local", "development", "test", "staging", "production"] },
+          "target_ref": { "type": "string", "minLength": 1, "maxLength": 160 }
+        }
+      }
+    }
+  },
+  "$defs": {
+    "projectPaths": {
+      "type": "array",
+      "maxItems": 100,
+      "uniqueItems": true,
+      "items": {
+        "type": "string",
+        "minLength": 1,
+        "maxLength": 240,
+        "not": { "pattern": "^(?:/|\\\\|[A-Za-z]:|\\.\\.(?:/|\\\\|$)|.*(?:/|\\\\)\\.\\.(?:/|\\\\|$))" }
+      }
+    }
+  }
+}

package/config/starter-source-acknowledgement.schema.json

@@ -0,0 +1,13 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://engineeringwith.ai/schemas/starter-source-acknowledgement-v1.json",
+  "type": "object",
+  "required": ["schema", "attemptId", "nonce", "status"],
+  "properties": {
+    "schema": { "const": "ewai.starter-source-acknowledgement/v1" },
+    "attemptId": { "type": "string", "format": "uuid" },
+    "nonce": { "type": "string", "format": "uuid" },
+    "status": { "const": "prepared" }
+  },
+  "additionalProperties": false
+}

package/config/starter-source-adapter.schema.json

@@ -0,0 +1,38 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://engineeringwith.ai/schemas/starter-source-adapter-v1.json",
+  "type": "object",
+  "required": ["schema", "id", "name", "publisher", "version", "protocolVersion", "sourceClasses", "entrypoint"],
+  "properties": {
+    "schema": { "const": "ewai.starter-source-adapter/v1" },
+    "id": { "type": "string", "pattern": "^[a-z][a-z0-9.-]{1,79}$" },
+    "name": { "type": "string", "minLength": 1, "maxLength": 240 },
+    "publisher": {
+      "type": "object",
+      "required": ["id", "name"],
+      "properties": {
+        "id": { "type": "string", "pattern": "^[a-z0-9]+(?:-[a-z0-9]+)*$" },
+        "name": { "type": "string", "minLength": 1, "maxLength": 240 }
+      },
+      "additionalProperties": false
+    },
+    "version": { "type": "string", "pattern": "^[0-9]+\\.[0-9]+\\.[0-9]+(?:[-+][0-9A-Za-z.-]+)?$" },
+    "protocolVersion": { "const": "1" },
+    "sourceClasses": {
+      "type": "array",
+      "minItems": 1,
+      "uniqueItems": true,
+      "items": { "enum": ["https", "git", "archive", "directory", "package", "opaque"] }
+    },
+    "entrypoint": { "$ref": "#/$defs/boundedPath" }
+  },
+  "additionalProperties": false,
+  "$defs": {
+    "boundedPath": {
+      "type": "string",
+      "minLength": 1,
+      "maxLength": 512,
+      "not": { "pattern": "(^/|^[A-Za-z]:|(^|[\\\\/])\\.\\.([\\\\/]|$)|[\\u0000-\\u001f])" }
+    }
+  }
+}

package/config/starter-source-request.schema.json

@@ -0,0 +1,61 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://engineeringwith.ai/schemas/starter-source-request-v1.json",
+  "type": "object",
+  "required": ["schema", "attemptId", "nonce", "project", "receipt", "stagingRoot", "limits"],
+  "properties": {
+    "schema": { "const": "ewai.starter-source-request/v1" },
+    "attemptId": { "type": "string", "format": "uuid" },
+    "nonce": { "type": "string", "format": "uuid" },
+    "project": {
+      "type": "object",
+      "required": ["name"],
+      "properties": { "name": { "type": "string", "minLength": 1, "maxLength": 240 } },
+      "additionalProperties": false
+    },
+    "receipt": {
+      "type": "object",
+      "required": ["id", "name", "source", "sourceClass", "version", "digest", "licence", "compatibility", "targets"],
+      "properties": {
+        "id": { "type": "string", "minLength": 1, "maxLength": 320 },
+        "name": { "type": "string", "minLength": 1, "maxLength": 240 },
+        "source": { "type": "string", "minLength": 1, "maxLength": 2048 },
+        "sourceClass": { "enum": ["https", "git", "archive", "directory", "package", "opaque"] },
+        "version": { "type": "string", "minLength": 1, "maxLength": 80 },
+        "digest": { "type": "string", "pattern": "^sha256:[a-f0-9]{64}$" },
+        "licence": { "type": "string", "minLength": 1, "maxLength": 240 },
+        "compatibility": { "type": "string", "minLength": 1, "maxLength": 500 },
+        "targets": {
+          "type": "array",
+          "minItems": 1,
+          "items": {
+            "type": "object",
+            "required": ["role", "sourcePath"],
+            "properties": {
+              "role": { "type": "string", "pattern": "^[a-z0-9]+(?:-[a-z0-9]+)*$" },
+              "sourcePath": { "type": "string", "minLength": 1, "maxLength": 512 }
+            },
+            "additionalProperties": false
+          }
+        }
+      },
+      "additionalProperties": false
+    },
+    "stagingRoot": { "type": "string", "minLength": 1 },
+    "limits": {
+      "type": "object",
+      "required": ["maximumDepth", "maximumPathBytes", "maximumFiles", "maximumFileBytes", "maximumTotalBytes", "timeoutMs", "maximumOutputBytes"],
+      "properties": {
+        "maximumDepth": { "type": "integer", "minimum": 1, "maximum": 24 },
+        "maximumPathBytes": { "type": "integer", "minimum": 1, "maximum": 512 },
+        "maximumFiles": { "type": "integer", "minimum": 1, "maximum": 5000 },
+        "maximumFileBytes": { "type": "integer", "minimum": 1, "maximum": 5242880 },
+        "maximumTotalBytes": { "type": "integer", "minimum": 1, "maximum": 104857600 },
+        "timeoutMs": { "type": "integer", "minimum": 1000, "maximum": 900000 },
+        "maximumOutputBytes": { "const": 65536 }
+      },
+      "additionalProperties": false
+    }
+  },
+  "additionalProperties": false
+}

package/package.json

@@ -0,0 +1,77 @@
+{
+  "name": "@thebackstoryis/engineering-with-ai",
+  "version": "0.2.9",
+  "description": "A human-centred, AI-augmented engineering pipeline",
+  "license": "SEE LICENSE IN LICENSE",
+  "author": "The Backstory Is",
+  "keywords": [
+    "ai",
+    "engineering",
+    "specifications",
+    "delivery-pipeline",
+    "personas",
+    "mcp"
+  ],
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/TheBackstoryIs/EngineeringWithAIHarness.git"
+  },
+  "homepage": "https://github.com/TheBackstoryIs/EngineeringWithAIHarness#readme",
+  "bugs": {
+    "url": "https://github.com/TheBackstoryIs/EngineeringWithAIHarness/issues"
+  },
+  "type": "module",
+  "bin": {
+    "ewai": "bin/ewai"
+  },
+  "engines": {
+    "node": ">=22.5"
+  },
+  "files": [
+    "agents-src/",
+    "bin/",
+    "config/",
+    "Docs/",
+    "packs/",
+    "public/",
+    "scripts/setup.mjs",
+    "scripts/publication-check.mjs",
+    "skills-src/",
+    "src/*.mjs",
+    "src/runtime/",
+    "tests/fixtures/context-benchmarks.json",
+    "!config/*-source-manifest.json",
+    "!config/workflow-migration-map.json",
+    "templates/"
+  ],
+  "publishConfig": {
+    "access": "public",
+    "registry": "https://registry.npmjs.org/"
+  },
+  "scripts": {
+    "build": "npm run check",
+    "precheck": "node scripts/publication-check.mjs --source-only && node --check src/runtime/tree-sitter-index.mjs && node --check src/design-system-application.mjs && node --check src/team-hub-resources.mjs && node --check src/dashboard-preferences.mjs && node --check public/dashboard-navigation.js",
+    "publication:check": "node scripts/publication-check.mjs",
+    "prepack": "node scripts/publication-check.mjs --quiet",
+    "check": "node --check src/error-reporting.mjs && node --check src/team-hub.mjs && node --check src/runtime/team-hub-client.mjs && node --check src/runtime/team-hub-database.mjs && node --check src/runtime/team-hub-server.mjs && node --check src/runtime/team-hub.mjs && node --check src/runtime/error-reporting.mjs && node --check src/launcher.mjs && node --check src/afk-worker.mjs && node --check src/companion-opening.mjs && node --check src/companion.mjs && node --check src/cli.mjs && node --check src/checkin.mjs && node --check src/persona-licence-config.mjs && node --check src/persona-website-provider.mjs && node --check src/persona-zip.mjs && node --check src/persona-entitlements.mjs && node --check src/context.mjs && node --check src/archaeology.mjs && node --check src/evidence-depth.mjs && node --check src/prototype-iterations.mjs && node --check src/solution-readiness.mjs && node --check src/delivery-artifacts.mjs && node --check src/delivery-documents.mjs && node --check src/delivery-gates.mjs && node --check src/delivery.mjs && node --check src/design-systems.mjs && node --check src/design-system-authoring.mjs && node --check src/execution-state.mjs && node --check src/intent-dependencies.mjs && node --check src/task-graph.mjs && node --check src/test-scenarios.mjs && node --check src/security-validation-config.mjs && node --check src/starter-materialisation-contract.mjs && node --check src/validation-config.mjs && node --check src/project.mjs && node --check src/install.mjs && node --check src/intents.mjs && node --check src/intent-maps.mjs && node --check src/discovery.mjs && node --check src/packs.mjs && node --check src/organisation-blueprints.mjs && node --check src/organisation-policies.mjs && node --check src/policy-design-gates.mjs && node --check src/policy-gate-integration.mjs && node --check src/personas.mjs && node --check src/platform-metadata-analysis.mjs && node --check src/power-platform-source-map.mjs && node --check src/salesforce-source-map.mjs && node --check src/repository-source-map.mjs && node --check src/runtime/context-assembly.mjs && node --check src/runtime/context-benchmarks.mjs && node --check src/runtime/database.mjs && node --check src/runtime/execution-leases.mjs && node --check src/runtime/provider-adapters.mjs && node --check src/runtime/security-validation.mjs && node --check src/runtime/starter-materialisation.mjs && node --check src/runtime/policy-workspace.mjs && node --check src/runtime/lifecycle-hooks.mjs && node --check src/runtime/afk-conductor.mjs && node --check src/runtime/dashboard-actions.mjs && node --check src/runtime/dashboard-handoffs.mjs && node --check src/runtime/persona-engagement.mjs && node --check src/runtime/evidence-depth-workspace.mjs && node --check src/runtime/prototype-iterations.mjs && node --check src/runtime/guided-discovery.mjs && node --check src/runtime/guided-intents.mjs && node --check src/runtime/phase-contributions.mjs && node --check src/runtime/impact-analysis.mjs && node --check src/runtime/paths.mjs && node --check src/runtime/intents.mjs && node --check src/runtime/knowledge.mjs && node --check src/runtime/palace.mjs && node --check src/runtime/repository-index.mjs && node --check src/runtime/runs.mjs && node --check src/runtime/work.mjs && node --check src/runtime/version.mjs && node --check src/runtime/dashboard.mjs && node --check src/runtime/dashboard-server.mjs && node --check src/runtime/mcp-config.mjs && node --check src/runtime/mcp-server.mjs && node --check public/app.js && node --check public/team-hub/app.js && node --check scripts/setup.mjs",
+    "test": "node --test",
+    "test:team-hub:coverage": "node --test --experimental-test-coverage --test-coverage-lines=90 --test-coverage-functions=85 --test-coverage-branches=75 --test-coverage-include='src/runtime/team-hub-client.mjs' --test-coverage-include='src/runtime/team-hub-database.mjs' tests/team-hub-server.test.mjs tests/team-hub-client.test.mjs tests/team-hub-resource-registry.test.mjs tests/team-hub-adapters.test.mjs tests/team-hub-operational.test.mjs",
+    "lint": "npm run check",
+    "setup": "node scripts/setup.mjs",
+    "typecheck": "npm run check",
+    "ewai": "node bin/ewai",
+    "context:benchmark": "node bin/ewai context benchmark --json"
+  },
+  "dependencies": {
+    "@modelcontextprotocol/sdk": "^1.29.0",
+    "tree-sitter": "^0.21.1",
+    "tree-sitter-javascript": "^0.21.4",
+    "tree-sitter-php": "^0.23.12",
+    "tree-sitter-typescript": "^0.21.2",
+    "yaml": "^2.8.1",
+    "zod": "^4.4.3"
+  },
+  "devDependencies": {
+    "playwright": "^1.55.0"
+  }
+}

package/packs/core/pack.yaml

@@ -0,0 +1,7 @@
+schema: ewai.pack/v1
+id: ewai.core
+name: EWAI Pipeline Core
+version: 0.1.0
+type: core
+description: Portable delivery workflow, project contracts, gates, and agent skills.
+boilerplates: []

package/packs/design-systems/default/experience-promise.md

@@ -0,0 +1,9 @@
+# Experience promise
+
+Create experiences that feel **calm, connected, accountable**.
+
+- Calm: make the current situation and next meaningful action understandable.
+- Connected: preserve relationships between a person's purpose, their work, its evidence, and its consequences.
+- Accountable: make ownership, decisions, uncertainty, and human authority visible.
+
+This is a portable fallback, not an organisation-approved brand system.

package/packs/design-systems/default/intentional-review.md

@@ -0,0 +1,10 @@
+# Intentional design and self-critique
+
+Make deliberate visual and interaction choices that arise from the product's
+purpose, users, evidence, and constraints. Avoid generic template composition.
+Use established components where they satisfy the need; record why novelty is
+necessary when they do not.
+
+Before selection, self-critique the work for purpose, agency, responsibility,
+familiarity, flexibility, simplicity, craft, meaningful delight, real content,
+empty and error states, accessibility evidence, and unresolved deviations.

package/packs/design-systems/default/interaction-and-entry.md

@@ -0,0 +1,9 @@
+# Interaction and entry modes
+
+Offer clear entry points for newcomers and efficient routes for experienced
+operators. Keep both routes connected to the same underlying state and
+authority. Prefer progressive disclosure, reversible choices, visible focus,
+and clear recovery over hidden automation.
+
+Interaction should communicate what happened, what remains, who is responsible,
+and whether the result is a proposal, recorded evidence, or an approved decision.

package/packs/design-systems/default/meaningful-content-and-states.md

@@ -0,0 +1,9 @@
+# Meaningful content and states
+
+Use realistic, purposeful copy rather than generic placeholder language. Design
+the empty, loading, partial, stale, error, blocked, success, and unavailable
+states as first-class parts of the journey. Each state should explain its
+meaning and the safest available next action.
+
+Do not hide uncertainty behind visual polish. Important status must remain
+understandable without relying on colour alone.

package/packs/design-systems/default/pack.yaml

@@ -0,0 +1,44 @@
+schema: ewai.pack/v1
+id: ewai.design-system.default
+name: EWAI Intentional Product Design
+description: Brand-neutral experience, interaction, content and review guidance for coherent UI Design and Prototype work.
+version: 1.0.0
+type: design-system
+requires: []
+design_system:
+  compatibility:
+    ewai: 0.x
+  provenance:
+    kind: owner-declared
+    summary: Portable default derived from the product-design principles agreed by the EWAI owner.
+  contributions:
+    - id: experience-promise
+      kind: experience
+      title: Experience promise
+      source: experience-promise.md
+      applicability: [ui-design, prototype, review]
+      required: true
+    - id: product-principles
+      kind: principles
+      title: Product design principles
+      source: principles.md
+      applicability: [ui-design, prototype, review]
+      required: true
+    - id: interaction-and-entry
+      kind: interaction
+      title: Interaction and entry modes
+      source: interaction-and-entry.md
+      applicability: [ui-design, prototype, review]
+      required: true
+    - id: meaningful-content-and-states
+      kind: states
+      title: Meaningful content and states
+      source: meaningful-content-and-states.md
+      applicability: [ui-design, prototype, content, review]
+      required: true
+    - id: intentional-review
+      kind: review
+      title: Intentional design and self-critique
+      source: intentional-review.md
+      applicability: [ui-design, prototype, review]
+      required: true

package/packs/design-systems/default/principles.md

@@ -0,0 +1,10 @@
+# Product design principles
+
+- Begin with purpose: explain why the work matters before presenting machinery.
+- Preserve agency: let people understand, choose, inspect, and recover.
+- Show responsibility: consequences, owners, evidence, limitations, and approvals should be legible.
+- Prefer familiar patterns and standard components before introducing novelty.
+- Support flexible routes for different experience levels without fragmenting the truth.
+- Pursue simplicity without minimalism: remove friction, not necessary context.
+- Apply craft deliberately to typography, spacing, hierarchy, language, and transitions.
+- Use delight with restraint, when it makes progress or understanding more human.

package/packs/personas/core/pack.yaml

@@ -0,0 +1,7 @@
+schema: ewai.pack/v1
+id: ewai.personas.core
+name: EWAI Core Personas
+version: 0.2.0
+type: persona
+description: Free personas for evidence-led discovery, knowledge curation, delivery, operation, and user-value assessment.
+boilerplates: []

package/packs/personas/core/personas/archaeologist.md

@@ -0,0 +1,37 @@
+---
+schema: ewai.persona/v1
+id: ewai.core.archaeologist
+name: EWAI Archaeologist
+version: 0.1.0
+category: engineering
+pack: ewai.personas.core
+tier: core
+tags: [archaeology, evidence, legacy, decisions, repository]
+capabilities: [project-archaeology, technology-discovery, evidence-triangulation, decision-reconstruction, impact-mapping]
+---
+
+# EWAI Archaeologist
+
+Reconstruct how an existing project behaves, how it evolved, and why it may have taken its current shape. Investigate source code, tests, configuration, schemas, Git history, documents, and human testimony with forensic curiosity and without blame.
+
+## Operating stance
+
+- Treat current code as evidence of behaviour, not proof of original intent or present approval.
+- Distinguish observed, corroborated, inferred, contradicted, and unknown claims.
+- Cite a file, line, commit, test, document, runtime observation, or named human source for every material finding.
+- Prefer multiple independent sources before raising confidence.
+- Preserve competing explanations and ask focused questions where the evidence cannot decide.
+- Identify accidental consistency separately from an intentional reusable pattern.
+- Do not modify production code, rewrite history, or promote inferred rules while investigating.
+
+## Questions to keep asking
+
+- What does the system demonstrably do?
+- When and why did this behaviour appear or change?
+- Which tests, interfaces, and consumers depend on it?
+- Which languages, frameworks, data stores, infrastructure, deployment targets, and version constraints are actually evidenced?
+- What decision or constraint would explain the evidence?
+- What contradicts that explanation?
+- Which person can confirm, correct, or retire the reconstructed understanding?
+
+Hand reviewed findings to the SPECS Knowledge Curator for routing. Keep every unconfirmed reconstruction in Archaeology evidence rather than presenting it as project truth.

package/packs/personas/core/personas/end-user.md

@@ -0,0 +1,17 @@
+---
+schema: ewai.persona/v1
+id: ewai.core.end-user
+name: End User
+version: 0.1.0
+category: product
+pack: ewai.personas.core
+tier: core
+tags: [usability, accessibility, outcomes]
+capabilities: [intent-review, design-review, acceptance-review]
+---
+
+# End User
+
+Focus on completing the intended job safely, clearly, and without unnecessary effort.
+
+Ask whether the workflow explains what is happening, supports recovery from mistakes, and produces a useful outcome.

package/packs/personas/core/personas/maintainer.md

@@ -0,0 +1,17 @@
+---
+schema: ewai.persona/v1
+id: ewai.core.maintainer
+name: Software Maintainer
+version: 0.1.0
+category: engineering
+pack: ewai.personas.core
+tier: core
+tags: [maintainability, architecture, testing]
+capabilities: [plan-review, code-review, retro-review]
+---
+
+# Software Maintainer
+
+Focus on whether future engineers can understand, test, extend, and safely remove the capability.
+
+Ask which contracts are stable, where coupling lives, and how regressions will be detected.

package/packs/personas/core/personas/operator.md

@@ -0,0 +1,17 @@
+---
+schema: ewai.persona/v1
+id: ewai.core.operator
+name: Service Operator
+version: 0.1.0
+category: operations
+pack: ewai.personas.core
+tier: core
+tags: [operations, observability, recovery]
+capabilities: [plan-review, test-review, delivery-review]
+---
+
+# Service Operator
+
+Focus on deployability, observable behaviour, supportability, incident recovery, and safe change.
+
+Ask how failures are detected, diagnosed, contained, and reversed.

package/packs/personas/core/personas/specs-knowledge-curator.md

@@ -0,0 +1,35 @@
+---
+schema: ewai.persona/v1
+id: ewai.core.specs-knowledge-curator
+name: SPECS Knowledge Curator
+version: 0.1.0
+category: information-management
+pack: ewai.personas.core
+tier: core
+tags: [specs, knowledge, traceability, documentation, governance]
+capabilities: [specs-routing, knowledge-curation, traceability, context-hygiene]
+---
+
+# SPECS Knowledge Curator
+
+Maintain SPECS as durable, human-readable project memory and a predictable context system for AI. Route reviewed knowledge to its canonical home, preserve provenance, and prevent documentation from becoming a confident second version of reality.
+
+## Routing responsibility
+
+- Route boundaries, domain language, inventories, APIs, research, handoffs, and personas to `SPECS/1.Scope/`.
+- Route intents, journeys, explorations, discussions, and requirements to `SPECS/2.Purpose/`.
+- Keep observations, archaeology, risks, tests, gates, incidents, and retrospectives in `SPECS/3.Evidence/`.
+- Promote only confirmed, accountable non-negotiables into `SPECS/4.Constraints/`.
+- Route accepted decisions, options, architecture, patterns, SOPs, runbooks, and plans to `SPECS/5.Strategy/`.
+- Keep implementation trackers and build outputs in `SPECS/6.Build/`.
+
+## Curation discipline
+
+- Do not turn an archaeological inference into a requirement, constraint, ADR, or persona without human review.
+- Link accepted knowledge back to its evidence and link superseding records without erasing history.
+- Reconcile duplication against an identified source of truth; preserve unresolved conflicts explicitly.
+- Keep unknowns searchable and owned rather than filling gaps with plausible prose.
+- Prefer concise, structured, accessible records that remain useful without an AI service.
+- Update indexes and cross-references whenever knowledge moves or changes status.
+
+Success means a person or agent can find what is known, understand why it is believed, see what remains uncertain, and identify who can decide.

package/packs/technologies/laravel/pack.yaml

@@ -0,0 +1,30 @@
+schema: ewai.pack/v1
+id: ewai.technology.laravel
+name: Laravel
+version: 0.1.0
+type: technology
+description: Laravel repository discovery, implementation, validation, and deployment guidance.
+compatibility:
+  languages: [php]
+  frameworks: [laravel]
+detection:
+  files: [artisan, composer.json]
+  dependencies: [laravel/framework]
+commands:
+  install: composer install
+  test: php artisan test
+  lint: vendor/bin/pint --test
+source_map:
+  profiles:
+    - id: laravel-routes
+      patterns: [routes/**/*.php]
+      analyser: tree-sitter
+      classification: framework-routing
+      priority: 50
+    - id: composer-manifest
+      patterns: [composer.json]
+      analyser: structured-keys
+      classification: dependency-manifest
+      priority: 40
+deployment: []
+boilerplates: []

package/packs/technologies/laravel-nuxt/pack.yaml

@@ -0,0 +1,30 @@
+schema: ewai.pack/v1
+id: ewai.stack.laravel-nuxt
+name: Laravel and Nuxt
+version: 0.1.0
+type: stack
+description: Composed API and web application stack with independently deployable Laravel and Nuxt repositories.
+requires:
+  - ewai.technology.laravel
+  - ewai.technology.nuxt
+repositories:
+  - role: backend
+    technology: ewai.technology.laravel
+  - role: frontend
+    technology: ewai.technology.nuxt
+source_map:
+  profiles:
+    - id: frontend-pages
+      patterns: [pages/**/*.vue, app/pages/**/*.vue]
+      analyser: tree-sitter
+      classification: user-interface
+      repositories: [frontend]
+      priority: 80
+    - id: backend-routes
+      patterns: [routes/**/*.php]
+      analyser: tree-sitter
+      classification: framework-routing
+      repositories: [backend]
+      priority: 80
+deployment: []
+boilerplates: []