@davidorex/pi-jit-agents 0.26.0 → 0.28.1

package/dist/types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -1,6 +1,9 @@
 {
 	"name": "@davidorex/pi-jit-agents",
-	"version": "0.26.0",
+	"version": "0.28.1",
+	"publishConfig": {
+		"access": "public"
+	},
 	"description": "Agent spec compilation and in-process dispatch runtime — the package that owns everything between 'I have a spec' and 'I have a typed result'",
 	"license": "MIT",
 	"author": "David Ryan",
@@ -49,16 +52,17 @@
 	"files": [
 		"dist/",
 		"schemas/",
+		"templates/",
 		"*.md"
 	],
 	"scripts": {
 		"clean": "rm -rf dist",
-		"build": "tsc -p tsconfig.build.json",
+		"build": "rm -rf dist && tsc -p tsconfig.build.json",
 		"prepublishOnly": "npm run clean && npm run build",
 		"test": "tsx --test src/*.test.ts"
 	},
 	"dependencies": {
-		"@davidorex/pi-context": "^0.26.0",
+		"@davidorex/pi-context": "^0.28.1",
 		"@earendil-works/pi-ai": "^0.75.4",
 		"nunjucks": "^3.2.4",
 		"proper-lockfile": "^4.1.2",

package/schemas/agent-trace.schema.json

@@ -1,14 +1,15 @@
 {
 	"$schema": "http://json-schema.org/draft-07/schema#",
 	"title": "Agent Trace Entry",
-	"description": "Discriminated union of trace events emitted during pi-jit-agents executeAgent invocations for monitor-classify pipelines. Each entry validates a single JSONL line; the .jsonl file as a whole is not a single JSON document. Per DEC-0004 the structural shape ({ type, id, parentId, timestamp, ...extra }) mirrors pi-coding-agent's SessionEntry but is deliberately a separate schema namespace — there is no literal inheritance. Per DEC-0005 these entries are produced by a push-write trace stream divergent from pi-mono's pull/replay model, so each variant is fired at the moment of occurrence inside executeAgent rather than reconstructed after the fact. The six variants form a parent-chained tree: session_start (root) → classify_call → { classify_response, context_collection } → verdict_decision; trace_end closes the session at the executeAgent exit boundary.",
+	"description": "Discriminated union of trace events emitted during pi-jit-agents executeAgent invocations for monitor-classify pipelines. Each entry validates a single JSONL line; the .jsonl file as a whole is not a single JSON document. The structural shape ({ type, id, parentId, timestamp, ...extra }) mirrors pi-coding-agent's SessionEntry but is deliberately a separate schema namespace — there is no literal inheritance. Entries are produced by a push-write trace stream divergent from pi-mono's pull/replay model, so each variant is fired at the moment of occurrence inside executeAgent rather than reconstructed after the fact. The six variants form a parent-chained tree: session_start (root) → classify_call → { classify_response, context_collection } → verdict_decision; trace_end closes the session at the executeAgent exit boundary.",
 	"oneOf": [
 		{ "$ref": "#/definitions/session_start" },
 		{ "$ref": "#/definitions/classify_call" },
 		{ "$ref": "#/definitions/classify_response" },
 		{ "$ref": "#/definitions/context_collection" },
 		{ "$ref": "#/definitions/verdict_decision" },
-		{ "$ref": "#/definitions/trace_end" }
+		{ "$ref": "#/definitions/trace_end" },
+		{ "$ref": "#/definitions/extension_load_warning" }
 	],
 	"definitions": {
 		"traceId": {
@@ -186,6 +187,33 @@
 				"totalDurationMs": { "type": "number" },
 				"verdict": { "$ref": "#/definitions/verdictResult" }
 			}
+		},
+		"extension_load_warning": {
+			"type": "object",
+			"additionalProperties": false,
+			"required": ["type", "id", "parentId", "timestamp", "extension_name", "message", "severity"],
+			"properties": {
+				"type": { "const": "extension_load_warning" },
+				"id": { "$ref": "#/definitions/traceId" },
+				"parentId": {
+					"type": ["null", "string"],
+					"description": "Extension-load events are typically root events (no parent classify session); null when emitted at extension factory boundary. May reference a parent trace when emitted from within a dispatched agent's lifecycle."
+				},
+				"timestamp": { "$ref": "#/definitions/isoTimestamp" },
+				"extension_name": {
+					"type": "string",
+					"description": "Name of the Pi extension emitting the warning (e.g., pi-agent-dispatch)."
+				},
+				"message": {
+					"type": "string",
+					"description": "Human-readable description of the observed condition (e.g., 'substrate config absent — composites empty')."
+				},
+				"severity": {
+					"type": "string",
+					"enum": ["info", "warning", "error"],
+					"description": "Severity classification per the canonical pi.ui.notify levels."
+				}
+			}
 		}
 	}
 }

package/templates/analyzers/base-analyzer.md

@@ -0,0 +1,9 @@
+{% block identity %}You are a code analyst.{% endblock %} Given an exploration summary and a code path to analyze:
+
+{% block checklist %}
+1. Analyze the code thoroughly
+{% endblock %}
+
+{% block constraints %}
+Be specific — cite files and line ranges where applicable.
+{% endblock %}

package/templates/analyzers/patterns-task.md

@@ -0,0 +1,11 @@
+Analyze design patterns at `{{ path }}`.
+
+{% if exploration.files is defined %}
+## Codebase
+{% for file in exploration.files %}
+- `{{ file.path }}` ({{ file.lines }} lines)
+{% endfor %}
+{% endif %}
+
+Identify patterns, conventions, and anti-patterns. Provide recommendations.
+Write your analysis as JSON conforming to the output schema.

package/templates/analyzers/patterns.md

@@ -0,0 +1,15 @@
+{% extends "analyzers/base-analyzer.md" %}
+
+{% block identity %}You are a design pattern analyst.{% endblock %}
+
+{% block checklist %}
+1. **Design patterns**: What patterns are used? Are they applied correctly?
+2. **Idioms**: What language/framework idioms are followed or violated?
+3. **Conventions**: Naming, file organization, import style — are they consistent?
+4. **Anti-patterns**: Are there patterns that work against the codebase?
+5. **Recommendations**: What patterns would improve the codebase?
+{% endblock %}
+
+{% block constraints %}
+Focus on patterns and conventions, not raw quality or architecture. Be specific — cite examples.
+{% endblock %}

package/templates/analyzers/quality-task.md

@@ -0,0 +1,11 @@
+Analyze code quality at `{{ path }}`.
+
+{% if exploration.files is defined %}
+## Codebase
+{% for file in exploration.files %}
+- `{{ file.path }}` ({{ file.lines }} lines)
+{% endfor %}
+{% endif %}
+
+Assess test coverage, error handling, code smells, and maintainability.
+Write your analysis as JSON conforming to the output schema.

package/templates/analyzers/quality.md

@@ -0,0 +1,15 @@
+{% extends "analyzers/base-analyzer.md" %}
+
+{% block identity %}You are a code quality analyst.{% endblock %}
+
+{% block checklist %}
+1. **Test coverage**: What is tested? What isn't? Are tests meaningful?
+2. **Error handling**: How are errors handled? Are there gaps?
+3. **Code smells**: Duplicated logic, overly complex functions, magic numbers?
+4. **Documentation**: Is the code documented? Are the docs accurate?
+5. **Maintainability**: How easy would it be to modify this code?
+{% endblock %}
+
+{% block constraints %}
+Focus on quality concerns, not architecture or design patterns. Be specific — cite files and line ranges.
+{% endblock %}

package/templates/analyzers/structure-task.md

@@ -0,0 +1,17 @@
+Analyze the code at `{{ path }}`.
+
+{% if exploration.files is defined %}
+## Prior Exploration
+{% for file in exploration.files %}
+- `{{ file.path }}` ({{ file.lines }} lines){% if file.exports %}: {{ file.exports | length }} exports{% endif %}
+{% endfor %}
+{% endif %}
+
+{% if exploration.types is defined %}
+## Known Types
+{% for t in exploration.types %}
+- `{{ t.name }}` ({{ t.kind }}) in `{{ t.file }}`
+{% endfor %}
+{% endif %}
+
+Write your analysis as JSON conforming to the output schema.

package/templates/analyzers/structure.md

@@ -0,0 +1,15 @@
+{% extends "analyzers/base-analyzer.md" %}
+
+{% block identity %}You are a code structure analyst.{% endblock %}
+
+{% block checklist %}
+1. **Architecture**: How is the code organized? What patterns are used?
+2. **Module boundaries**: Are responsibilities clearly separated?
+3. **Dependencies**: What are the key dependency relationships?
+4. **Entry points**: How does execution flow through the code?
+5. **Configuration**: How is the system configured?
+{% endblock %}
+
+{% block constraints %}
+Focus on structural concerns, not code quality or patterns. Be specific — cite files and directories.
+{% endblock %}

package/templates/architecture-designer/task.md

@@ -0,0 +1,117 @@
+## Project Identity
+
+**Name:** {{ project.name }}
+**Description:** {{ project.description }}
+**Core Value:** {{ project.core_value }}
+{% if project.stack %}
+
+### Stack
+{% for item in project.stack %}
+- {{ item }}
+{% endfor %}
+{% endif %}
+
+### Constraints
+{% for constraint in project.constraints %}
+- [{{ constraint.type }}] {{ constraint.description }}
+{% endfor %}
+
+### Scope Boundaries
+
+**In scope:**
+{% for item in project.scope_boundaries.in %}
+- {{ item }}
+{% endfor %}
+
+**Out of scope:**
+{% for item in project.scope_boundaries.out %}
+- {{ item }}
+{% endfor %}
+
+## Requirements
+
+### Must
+{% for req in requirements.requirements %}
+{% if req.priority == "must" %}
+- **{{ req.id }}** [{{ req.type }}]: {{ req.description }}
+{% endif %}
+{% endfor %}
+
+### Should
+{% for req in requirements.requirements %}
+{% if req.priority == "should" %}
+- **{{ req.id }}** [{{ req.type }}]: {{ req.description }}
+{% endif %}
+{% endfor %}
+
+### Could
+{% for req in requirements.requirements %}
+{% if req.priority == "could" %}
+- **{{ req.id }}** [{{ req.type }}]: {{ req.description }}
+{% endif %}
+{% endfor %}
+
+## Instructions
+
+Design the initial architecture for this project. Produce modules, patterns, and boundaries that satisfy the requirements above — starting with "must" requirements and ensuring "should" requirements have a clear home.
+
+### For each module, provide:
+
+1. **name** — short identifier (e.g., "api", "auth", "storage", "cli")
+2. **file** — primary file path relative to project root (e.g., "src/api.ts")
+3. **responsibility** — one sentence: what this module owns and what it does not
+4. **dependencies** — array of other module names this depends on (empty if none)
+5. **lines** — estimated lines of code (rough order of magnitude)
+
+### For each pattern, provide:
+
+1. **name** — recognized pattern name (e.g., "Repository Pattern", "Event Sourcing", "Middleware Pipeline")
+2. **description** — why this pattern is appropriate for this project's specific needs
+3. **used_in** — array of module names that implement this pattern
+
+### For boundaries, provide:
+
+An array of strings — each describing a hard architectural constraint. These should be specific to this project, not generic ("All database access goes through the storage module", not "separate concerns").
+
+### Design principles
+
+- Module count should be proportional to requirements — a 5-requirement project needs 3-5 modules, not 15
+- Every "must" functional requirement should map to at least one module's responsibility
+- Every "must" non-functional requirement should be addressed by a pattern or boundary
+- Dependencies should flow in one direction — avoid circular module dependencies
+- If the project has a stated stack, modules should use file extensions and conventions matching that stack
+- Prefer explicit boundaries over implicit conventions
+
+### Overview
+
+Write an `overview` paragraph (required) summarizing:
+- The architectural style (layered, modular, pipeline, etc.)
+- The key structural decisions and why they fit this project
+- How the architecture supports the core_value
+
+### Output format
+
+Produce a single JSON object:
+
+```json
+{
+  "overview": "string (required)",
+  "modules": [
+    {
+      "name": "string (required)",
+      "file": "string (required)",
+      "responsibility": "string (required)",
+      "dependencies": ["string"],
+      "lines": 100
+    }
+  ],
+  "patterns": [
+    {
+      "name": "string (required)",
+      "description": "string (required)",
+      "used_in": ["module-name"]
+    }
+  ],
+  "boundaries": ["string"]
+}
+```

package/templates/architecture-inferrer/task.md

@@ -0,0 +1,61 @@
+Infer the architecture of the project at `{{ path }}`.
+
+## Codebase Analysis
+
+{% if exploration.files is defined %}
+### Files
+{% for file in exploration.files %}
+- `{{ file.path }}` ({{ file.language | default("unknown") }}, {{ file.lines | default("?") }} lines){% if file.exports %} — {{ file.exports | length }} exports{% endif %}
+{% endfor %}
+{% endif %}
+
+{% if exploration.types is defined %}
+### Types
+{% for t in exploration.types %}
+- `{{ t.name }}` ({{ t.kind }}) in `{{ t.file }}`
+{% endfor %}
+{% endif %}
+
+{% if exploration.dependencies is defined %}
+### Dependencies
+{% for d in exploration.dependencies %}
+- `{{ d.from }}` → `{{ d.to }}` ({{ d.type | default("import") }})
+{% endfor %}
+{% endif %}
+
+{% if exploration.entryPoints is defined %}
+### Entry Points
+{% for ep in exploration.entryPoints %}
+- `{{ ep }}`
+{% endfor %}
+{% endif %}
+
+## Instructions
+
+From the analysis above and targeted code reads, produce an architecture block:
+
+1. **Modules** — each cohesive unit with a clear responsibility. For each:
+   - `name`: concise identifier (e.g., "block-api", "expression-engine")
+   - `file`: primary file path relative to project root
+   - `responsibility`: one-sentence description of what this module does
+   - `dependencies`: array of other module names this module depends on
+   - `lines`: approximate line count
+
+2. **Patterns** — design patterns evidenced in the code. For each:
+   - `name`: pattern name (e.g., "registry", "factory", "middleware")
+   - `description`: how this pattern is applied in this codebase
+   - `used_in`: array of module names that use this pattern
+
+3. **Boundaries** — architectural seams where modules interact through defined interfaces (e.g., "block-api validates all writes before persistence", "dispatch spawns subprocesses through a single entry point")
+
+4. **Overview** — one paragraph summarizing the architecture: what the system does, how it's organized, and what the key design decisions are
+
+Read entry points, config files, and module interfaces to confirm the exploration. Do not read every file.
+
+## Required Output Schema
+
+You MUST produce JSON conforming exactly to this schema. Every required field must be present.
+
+```json
+{{ output_schema }}
+```

package/templates/audit-finding-verifier/task.md

@@ -0,0 +1,59 @@
+Verify whether the following audit findings have been resolved.
+
+## Audit Findings
+
+{% for finding in audit.findings %}
+### Finding: {{ finding.id }}
+
+**Description**: {{ finding.description }}
+**Severity**: {{ finding.severity | default("unspecified") }}
+**Category**: {{ finding.category | default("unspecified") }}
+**Principle**: {{ finding.principle | default("unspecified") }}
+
+**Locations**:
+{% for loc in finding.locations %}
+- `{{ loc.file }}` {% if loc.line %}line {{ loc.line }}{% endif %} {% if loc.description %} — {{ loc.description }}{% endif %}
+{% endfor %}
+
+{% if finding.fix %}
+**Fix suggestion**: {{ finding.fix.suggestion | default("none") }}
+{% endif %}
+
+{% if finding.resolution and finding.resolution.status == 'passed' %}
+*Previously marked as resolved — re-verify.*
+{% endif %}
+---
+{% endfor %}
+
+## Implementation Results
+
+{% if implementation_results is iterable and implementation_results is not string %}
+{% for result in implementation_results %}
+- {{ result.spec_name | default(result.name | default("task")) }}: {{ result.status | default("unknown") }}
+{% endfor %}
+{% else %}
+```json
+{{ implementation_results | dump(2) }}
+```
+{% endif %}
+
+{% if conformance_reference %}
+## Conformance Reference
+
+```json
+{{ conformance_reference | dump(2) }}
+```
+{% endif %}
+
+## Instructions
+
+For EACH finding above:
+
+1. Read the code at the referenced location(s)
+2. Determine if the finding's described issue is addressed
+3. Record your verdict: `passed`, `failed`, or `needs_inspect`
+4. Provide specific evidence (code snippet, file:line reference)
+
+Do NOT use grep exit codes as evidence. Read the code and assess whether the issue described in the finding is genuinely resolved.
+
+Produce JSON output with a `findings` array containing one entry per finding, plus summary statistics.

package/templates/audit-fixer/task.md

@@ -0,0 +1,67 @@
+## Audit Findings to Fix
+
+### Principle: {{ task.principle }}
+### Category: {{ task.category }}
+### Severity: {{ task.severity }}
+
+### Findings
+
+{% for finding in task.findings %}
+#### {{ finding.id }}: {{ finding.description }}
+
+{% for loc in finding.locations %}
+- `{{ loc.file }}` lines {{ loc.lines | join(', ') }}
+{% endfor %}
+
+{% if finding.fix %}
+**Fix**: {{ finding.fix.suggestion }}
+{% if finding.fix.verify_method == "grep" %}
+**Verify**: pattern `{{ finding.fix.verify_pattern }}` should NOT match after fix
+{% endif %}
+{% endif %}
+
+{% endfor %}
+
+### Files to Modify
+
+{% for file in task.files %}
+- `{{ file }}`
+{% endfor %}
+
+### Acceptance Criteria
+
+{% for criterion in task.acceptance_criteria %}
+- {{ criterion }}
+{% endfor %}
+
+{% if conformance_reference %}
+### Conformance Reference
+
+{% for principle in conformance_reference.principles %}
+{% if principle.id == task.principle.split(':')[0] %}
+#### {{ principle.name }}
+
+{{ principle.description }}
+
+{% for rule in principle.rules %}
+- **{{ rule.id }}**: {{ rule.rule }}
+{% if rule.examples %}
+  - Correct: `{{ rule.examples[0] }}`
+{% endif %}
+{% if rule.anti_patterns %}
+  - Wrong: `{{ rule.anti_patterns[0] }}`
+{% endif %}
+{% endfor %}
+{% endif %}
+{% endfor %}
+{% endif %}
+
+## Instructions
+
+1. Read the files listed above to understand the current code
+2. Fix each finding according to the fix suggestion
+3. Ensure fixes follow the conformance reference principles
+4. Run the test suite: `node --experimental-strip-types --test src/*.test.ts`
+5. Fix any test failures caused by your changes
+
+Produce a JSON result conforming to the execution-results schema.

package/templates/audit-results-router/task.md

@@ -0,0 +1,37 @@
+Review the audit fix results and produce a routing manifest.
+
+## Implementation Results
+
+{% if implementation_results is iterable and implementation_results is not string %}
+{% for result in implementation_results %}
+### Task: {{ result.spec_name | default(result.name | default("unnamed")) }}
+
+- Status: {{ result.status | default("unknown") }}
+{% if result.decisions %}
+- Decisions: {{ result.decisions | length }}
+{% endif %}
+{% if result.issues %}
+- Issues flagged: {{ result.issues | length }}
+{% endif %}
+{% endfor %}
+{% else %}
+```json
+{{ implementation_results | dump(2) }}
+```
+{% endif %}
+
+## Verification Results
+
+```json
+{{ verification | dump(2) }}
+```
+
+## Instructions
+
+Produce a routing manifest with:
+
+1. **decisions** — validated decisions from implementation results (with complete id, description, rationale fields)
+2. **new_issues** — genuine issues that should be tracked (with stable id, description, status: "open", category, priority)
+3. **summary** — accurate summary of what was completed, what failed, what needs inspection
+
+Only include items that are well-formed and represent genuine project artifacts. Do not route items that are missing required fields or describe hypothetical concerns.

package/templates/decomposer/task.md

@@ -0,0 +1,56 @@
+## Decomposition Request
+
+**Gap:** {{ gap.id }} — {{ gap.description }}
+
+## Investigation Findings
+
+**Complexity:** {{ investigation.complexity }}
+**Summary:** {{ investigation.summary }}
+
+### Affected Files
+{% for f in investigation.affected_files %}
+- `{{ f.path }}` — {{ f.role }}: {{ f.current_behavior }}
+{% endfor %}
+
+### Constraints
+{% for c in investigation.constraints %}
+- {{ c }}
+{% endfor %}
+
+### Risks
+{% for r in investigation.risks %}
+- {{ r }}
+{% endfor %}
+
+{% if research %}
+## Research Findings
+
+### Patterns
+{% for p in research.patterns %}
+- **{{ p.name }}**: {{ p.description }} — {{ p.applicability }}
+{% endfor %}
+
+### Recommendations
+{% for r in research.recommendations %}
+- {{ r }}
+{% endfor %}
+{% endif %}
+
+## Instructions
+
+Decompose this gap into implementation specs. Each spec is a unit of work for a single implementing agent.
+
+1. Break the work into the smallest meaningful units
+2. Declare file targets for each spec
+3. Set `depends_on` for specs that must be sequential (shared files, interface dependencies)
+4. Mark `parallel_safe` for specs that can run concurrently
+5. Write acceptance criteria that are verifiable (grep patterns, test commands, not "it works")
+6. Estimate complexity per spec
+
+## Required Output Schema
+
+You MUST produce JSON conforming exactly to this schema. Every required field must be present.
+
+```json
+{{ output_schema }}
+```

package/templates/explorer/system.md

@@ -0,0 +1,3 @@
+You are a code explorer. Given a path, produce a comprehensive structural overview as JSON.
+
+Include files with their sizes, exports, imports, and line counts. Identify types, interfaces, and key functions. Map dependencies between files.

package/templates/explorer/task.md

@@ -0,0 +1,9 @@
+Explore the code at `{{ path }}`.
+
+Produce a JSON object with:
+- `files`: array of { path, type, language, lines, exports, imports }
+- `types`: array of { name, file, line, kind, definition }
+- `dependencies`: array of { from, to, type }
+- `entryPoints`: array of file paths that serve as entry points
+
+Write your findings as valid JSON.