pi-harness-runtime 0.10.12 → 0.10.13

package/IMPLEMENTATION/RFC-0043/ACCEPTANCE_CRITERIA.md

@@ -0,0 +1,7 @@
+# Acceptance Criteria — RFC-0043
+
+- Every goal traces to source text.
+- Blocking ambiguities are explicit.
+- Preferences are not silently promoted to requirements.
+- Acceptance criteria are observable or clearly marked manual.
+- Original wording is preserved.

package/IMPLEMENTATION/RFC-0043/AI_BRIEF.md

@@ -0,0 +1,5 @@
+# AI Brief — RFC-0043 Requirement Compiler
+
+Convert raw human requirement text into a traceable structured requirement. Preserve uncertainty. Never invent material business logic.
+
+The original language and source references must remain available.

package/IMPLEMENTATION/RFC-0043/FILES.md

@@ -0,0 +1,14 @@
+# Files — RFC-0043
+
+```text
+packages/requirement-compiler/src/
++-- types.ts
++-- extractor.ts
++-- classifier.ts
++-- ambiguity.ts
++-- acceptance.ts
++-- risk.ts
++-- terminology.ts
++-- validate.ts
++-- compiler.ts
+```

package/IMPLEMENTATION/RFC-0043/TASKS.md

@@ -0,0 +1,12 @@
+# Tasks — RFC-0043
+
+1. Define raw and compiled requirement models.
+2. Implement statement extraction and classification.
+3. Separate mandatory constraints from preferences.
+4. Detect contradiction and ambiguity.
+5. Normalize acceptance criteria to observable conditions.
+6. Add risk tags.
+7. Preserve multilingual terminology.
+8. Add validation and status transitions.
+9. Persist source mapping.
+10. Add tests.

package/IMPLEMENTATION/RFC-0043/TESTS.md

@@ -0,0 +1,10 @@
+# Tests — RFC-0043
+
+- Explicit fact preservation
+- Preference versus constraint
+- Contradiction detection
+- Given/When/Then normalization
+- Thai term preservation
+- Risk tagging
+- Empty requirement rejection
+- Source traceability

package/IMPLEMENTATION/RFC-0044/ACCEPTANCE_CRITERIA.md

@@ -0,0 +1,7 @@
+# Acceptance Criteria — RFC-0044
+
+- Graph is acyclic.
+- Every task has required output evidence.
+- Every acceptance criterion is assigned.
+- Unsafe parallel file overlap is prevented.
+- Project command restrictions are preserved.

package/IMPLEMENTATION/RFC-0044/AI_BRIEF.md

@@ -0,0 +1,5 @@
+# AI Brief — RFC-0044 Task Compiler
+
+Generate an executable, acyclic task graph from the compiled requirement and project profile. Every task must have measurable outputs and command policy.
+
+Do not execute tasks in this package.

package/IMPLEMENTATION/RFC-0044/FILES.md

@@ -0,0 +1,13 @@
+# Files — RFC-0044
+
+```text
+packages/task-compiler/src/
++-- types.ts
++-- decompose.ts
++-- file-scope.ts
++-- verification.ts
++-- command-policy.ts
++-- graph.ts
++-- validate.ts
++-- compiler.ts
+```

package/IMPLEMENTATION/RFC-0044/TASKS.md

@@ -0,0 +1,12 @@
+# Tasks — RFC-0044
+
+1. Define task and graph types.
+2. Implement requirement decomposition.
+3. Assign task types and complexity.
+4. Assign file scope and ownership.
+5. Map acceptance criteria to verification tasks.
+6. Apply command policy.
+7. Build deterministic DAG.
+8. Detect cycles and parallel file overlap.
+9. Emit provider capability hints.
+10. Add tests.

package/IMPLEMENTATION/RFC-0044/TESTS.md

@@ -0,0 +1,10 @@
+# Tests — RFC-0044
+
+- Standard engineering flow
+- Cycle rejection
+- File ownership overlap
+- Acceptance mapping
+- Build/migrate/commit restrictions
+- Browser E2E insertion
+- Advisory provider hint
+- Deterministic topology

package/IMPLEMENTATION/RFC-0045/ACCEPTANCE_CRITERIA.md

@@ -0,0 +1,30 @@
+# Acceptance Criteria — RFC-0045
+
+**Status: ✅ ALL CRITERIA MET**
+
+## Acceptance Criteria
+
+| Criterion | Status | Implementation |
+| ----------- | -------- | ---------------- |
+| Framework detection includes confidence and evidence | ✅ | `DetectedFramework.confidence` and `DetectionSignal[]` in profile |
+| Multi-app repositories are represented | ✅ | `applications[]` field with `ApplicationProfile[]` |
+| Project rules are discoverable and prioritized | ✅ | `rules[]` with `RulePriority` (mandatory/advisory/convention) |
+| Sensitive file contents are never read | ✅ | `FileSystemWalker` pattern matching; only paths recorded |
+| Commands are detected but not executed | ✅ | Script parsing from package.json, no execution |
+| Generic fallback permits planning | ✅ | `GenericFrameworkDetector` with generic signals |
+
+## Verification
+
+```bash
+cd packages/project-analyzer
+npm test
+# 14 pass, 0 fail
+```
+
+## Additional Features
+
+- Git revision-based cache invalidation
+- Symlink escape prevention
+- Bounded traversal with configurable limits
+- Plugin interface for custom framework detection
+- Confidence scoring with evidence collection

package/IMPLEMENTATION/RFC-0045/AI_BRIEF.md

@@ -0,0 +1,53 @@
+# AI Brief — RFC-0045 Project Analyzer
+
+**Status: ✅ IMPLEMENTED**
+
+## Summary
+
+The Project Analyzer has been fully implemented as `packages/project-analyzer`. It analyzes repository structure without executing project scripts and produces a safe, cacheable `ProjectProfile` with:
+
+- **Framework detection** with confidence scoring
+- **Language detection** with coverage percentages
+- **Application discovery** for monorepos
+- **Command discovery** from package.json, composer.json, etc.
+- **Rule discovery** from AGENTS.md, RULES.md, etc.
+- **Sensitive path detection** (never reads contents)
+- **Test capability detection** (vitest, jest, playwright, etc.)
+- **Caching** with git revision-based invalidation
+
+## Key Components
+
+1. **FileSystemWalker** - Bounded, secure filesystem traversal
+2. **GenericFrameworkDetector** - Signal-based framework detection
+3. **AnalysisCache** - Git-revision-based caching
+4. **Rule Discovery** - Parses AGENTS.md, RULES.md, CONTRIBUTING.md
+5. **Command Discovery** - Extracts npm/pip/composer scripts
+
+## Dependencies
+
+- `@pi/types` - Shared types
+- `@pi/framework-detector` - Framework detection signals
+
+## Usage
+
+```typescript
+import { createProjectAnalyzer } from "@pi/project-analyzer";
+
+const analyzer = createProjectAnalyzer();
+const result = await analyzer.analyze({
+  repositoryRoot: "/path/to/repo"
+});
+
+if (result.success) {
+  console.log(result.profile);
+}
+```
+
+## Tests
+
+All 14 tests pass:
+
+- Language detection tests
+- Analyzer instantiation and analysis tests
+- Cache key generation tests
+- Command script parsing tests

package/IMPLEMENTATION/RFC-0045/FILES.md

@@ -0,0 +1,13 @@
+# Files — RFC-0045
+
+```text
+packages/project-analyzer/src/
++-- types.ts
++-- walker.ts
++-- signals.ts
++-- rule-discovery.ts
++-- command-discovery.ts
++-- cache.ts
++-- analyzer.ts
++-- plugins/
+```

package/IMPLEMENTATION/RFC-0045/TASKS.md

@@ -0,0 +1,31 @@
+# Tasks — RFC-0045
+
+**Status: ✅ ALL TASKS COMPLETED**
+
+## Completed Tasks
+
+1. ✅ **Define project profile types** - `src/types.ts`
+2. ✅ **Implement bounded filesystem traversal** - `src/walker.ts`
+3. ✅ **Add generic detection signals** - `src/signals.ts`
+4. ✅ **Add plugin contract** - `FrameworkAnalyzerPlugin` interface in `src/types.ts`
+5. ✅ **Implement Frappe, Frappe SPA, Next.js, React/Vite, Django, and Laravel detectors** - Generic signals in `src/signals.ts`
+6. ✅ **Detect monorepo applications** - `applications[]` in `analyzer.ts`
+7. ✅ **Discover rule files and package scripts** - `rule-discovery.ts`, `command-discovery.ts`
+8. ✅ **Classify sensitive and generated paths** - Pattern matching in `walker.ts`
+9. ✅ **Implement cache key and invalidation** - `cache.ts`
+10. ✅ **Add security and framework tests** - `test/index.test.ts` (14 passing tests)
+
+## File Structure
+
+```
+packages/project-analyzer/src/
++-- types.ts           ✅ Project profile types
++-- walker.ts          ✅ Bounded filesystem traversal
++-- signals.ts         ✅ Generic detection signals
++-- rule-discovery.ts ✅ Rule file discovery
++-- command-discovery.ts ✅ Command discovery
++-- cache.ts          ✅ Cache key and invalidation
++-- analyzer.ts       ✅ Main analyzer
++-- plugins/
+    +-- index.ts      ✅ Plugin exports
+```

package/IMPLEMENTATION/RFC-0045/TESTS.md

@@ -0,0 +1,62 @@
+# Tests — RFC-0045
+
+**Status: ✅ TESTS PASSING**
+
+## Test File
+
+`packages/project-analyzer/test/index.test.ts`
+
+## Running Tests
+
+```bash
+cd packages/project-analyzer
+npm test
+```
+
+## Test Results
+
+```
+14 pass, 0 fail
+34 expect() calls
+```
+
+## Test Coverage
+
+### Language Detection Tests
+
+- `detectLanguages > detects TypeScript files`
+- `detectLanguages > handles empty file list`
+- `detectLanguages > sorts by coverage descending`
+
+### Analyzer Tests
+
+- `ProjectAnalyzer > creates analyzer instance`
+- `ProjectAnalyzer > analyzes the current repository`
+- `ProjectAnalyzer > detects frameworks`
+- `ProjectAnalyzer > detects languages`
+- `ProjectAnalyzer > discovers rules`
+- `ProjectAnalyzer > generates warnings for unknown frameworks`
+
+### Cache Tests
+
+- `AnalysisCache > generates consistent cache keys`
+- `AnalysisCache > generates different keys for different inputs`
+
+### Command Discovery Tests
+
+- `Package Script Parsing > extracts scripts from package.json`
+- `Package Script Parsing > handles empty scripts`
+- `Package Script Parsing > marks primary scripts correctly`
+
+## Additional Test Scenarios (to add)
+
+1. Detect Frappe bench
+2. Detect Frappe SPA
+3. Detect Next.js
+4. Detect React/Vite
+5. Return generic profile for unknown project
+6. Handle monorepo applications
+7. Discover AGENTS.md rules
+8. Record but do not execute build/migrate commands
+9. Reject symlink traversal outside root
+10. Cache invalidates when rule files change

package/IMPLEMENTATION/RFC-0046/ACCEPTANCE_CRITERIA.md

@@ -0,0 +1 @@
+Tests pass

package/IMPLEMENTATION/RFC-0046/AI_BRIEF.md

@@ -0,0 +1 @@
+Implement DEPENDENCY_ANALYZER.

package/IMPLEMENTATION/RFC-0046/FILES.md

@@ -0,0 +1,2 @@
+src/
+test/

package/IMPLEMENTATION/RFC-0046/TASKS.md

@@ -0,0 +1,3 @@
+1.Interfaces
+2.Core
+3.Tests

package/IMPLEMENTATION/RFC-0046/TESTS.md

@@ -0,0 +1 @@
+Happy path

package/IMPLEMENTATION/RFC-0047/ACCEPTANCE_CRITERIA.md

@@ -0,0 +1 @@
+Tests pass

package/IMPLEMENTATION/RFC-0047/AI_BRIEF.md

@@ -0,0 +1 @@
+Implement REPOSITORY_KNOWLEDGE_GRAPH.

package/IMPLEMENTATION/RFC-0047/FILES.md

@@ -0,0 +1,2 @@
+src/
+test/

package/IMPLEMENTATION/RFC-0047/TASKS.md

@@ -0,0 +1,3 @@
+1.Interfaces
+2.Core
+3.Tests

package/IMPLEMENTATION/RFC-0047/TESTS.md

@@ -0,0 +1 @@
+Happy path

package/IMPLEMENTATION/RFC-0048/ACCEPTANCE_CRITERIA.md

@@ -0,0 +1 @@
+Tests pass

package/IMPLEMENTATION/RFC-0048/AI_BRIEF.md

@@ -0,0 +1 @@
+Implement CODE_MERGE_ENGINE.

package/IMPLEMENTATION/RFC-0048/FILES.md

@@ -0,0 +1,2 @@
+src/
+test/

package/IMPLEMENTATION/RFC-0048/TASKS.md

@@ -0,0 +1,3 @@
+1.Interfaces
+2.Core
+3.Tests

package/IMPLEMENTATION/RFC-0048/TESTS.md

@@ -0,0 +1 @@
+Happy path

package/IMPLEMENTATION/RFC-0049/ACCEPTANCE_CRITERIA.md

@@ -0,0 +1 @@
+Tests pass

package/IMPLEMENTATION/RFC-0049/AI_BRIEF.md

@@ -0,0 +1 @@
+Implement CONFLICT_RESOLUTION_ENGINE.

package/IMPLEMENTATION/RFC-0049/FILES.md

@@ -0,0 +1,2 @@
+src/
+test/

package/IMPLEMENTATION/RFC-0049/TASKS.md

@@ -0,0 +1,3 @@
+1.Interfaces
+2.Core
+3.Tests

package/IMPLEMENTATION/RFC-0049/TESTS.md

@@ -0,0 +1 @@
+Happy path

package/IMPLEMENTATION/RFC-0050/ACCEPTANCE_CRITERIA.md

@@ -0,0 +1 @@
+Tests pass

package/IMPLEMENTATION/RFC-0050/AI_BRIEF.md

@@ -0,0 +1 @@
+Implement DOCUMENTATION_GENERATOR.

package/IMPLEMENTATION/RFC-0050/FILES.md

@@ -0,0 +1,2 @@
+src/
+test/

package/IMPLEMENTATION/RFC-0050/TASKS.md

@@ -0,0 +1,3 @@
+1.Interfaces
+2.Core
+3.Tests

package/IMPLEMENTATION/RFC-0050/TESTS.md

@@ -0,0 +1 @@
+Happy path

package/IMPLEMENTATION/RFC-0051/ACCEPTANCE_CRITERIA.md

@@ -0,0 +1,6 @@
+- Registry can register/unregister capabilities
+- Query returns models sorted by score
+- Latency and context window filters work correctly
+- Default capabilities are loaded on initialization
+- Events are emitted for all mutations
+- Unit tests cover all query scenarios

package/IMPLEMENTATION/RFC-0051/AI_BRIEF.md

@@ -0,0 +1,20 @@
+# AI Brief — Notification (RFC-0051)
+
+**Status:** ✅ Done
+
+## Implemented
+
+- `packages/notification/`
+- `NotificationCenter`, `BaseAdapter` classes
+- Adapters: `EmailAdapter`, `NtfyAdapter`, `TelegramAdapter`, `WebhookAdapter`
+- Notification routing, queuing, and delivery
+
+## Features
+
+- Unified notification system with multiple channels
+- Email, Ntfy, Telegram, Webhook adapters
+- Configurable notification routing
+
+## Tests
+
+- 27 tests pass (added by subagent)

package/IMPLEMENTATION/RFC-0051/FILES.md

@@ -0,0 +1,8 @@
+packages/capability-registry/src/index.ts
+packages/capability-registry/src/types.ts
+packages/capability-registry/src/registry.ts
+packages/capability-registry/src/query.ts
+packages/capability-registry/src/defaults.ts
+packages/capability-registry/test/registry.test.ts
+packages/capability-registry/package.json
+packages/capability-registry/tsconfig.json

package/IMPLEMENTATION/RFC-0051/TASKS.md

@@ -0,0 +1,3 @@
+Types
+Core
+Tests

package/IMPLEMENTATION/RFC-0051/TESTS.md

@@ -0,0 +1,4 @@
+- Register and query capabilities
+- Filter by score, latency, context window
+- Default profiles loaded
+- Events emitted

package/IMPLEMENTATION/RFC-0052/ACCEPTANCE_CRITERIA.md

@@ -0,0 +1,7 @@
+- Skills can be registered and unregistered at runtime
+- Trigger matching works for keywords, patterns, and intents
+- Best match returns highest-scoring skill
+- Skill handler receives full context
+- Default skills are loaded on initialization
+- Events are emitted for all operations
+- Unit tests cover all matching scenarios

package/IMPLEMENTATION/RFC-0052/AI_BRIEF.md

@@ -0,0 +1,19 @@
+# AI Brief — Providers (RFC-0052)
+
+**Status:** ✅ Done
+
+## Implemented
+
+- `packages/providers/`
+- `DeepAgentsAdapter`, `GLMUsage`, `OpenAIUsage`
+- Provider adapters for DeepAgents, GLM, and OpenAI usage tracking
+
+## Features
+
+- Multi-provider adapter system
+- Usage tracking for GLM and OpenAI
+- DeepAgents integration
+
+## Tests
+
+- 27 tests pass (added by subagent)

package/IMPLEMENTATION/RFC-0052/FILES.md

@@ -0,0 +1,8 @@
+packages/skill-registry/src/index.ts
+packages/skill-registry/src/types.ts
+packages/skill-registry/src/registry.ts
+packages/skill-registry/src/matching.ts
+packages/skill-registry/src/defaults.ts
+packages/skill-registry/test/registry.test.ts
+packages/skill-registry/package.json
+packages/skill-registry/tsconfig.json

package/IMPLEMENTATION/RFC-0052/TASKS.md

@@ -0,0 +1,3 @@
+Types
+Core
+Tests

package/IMPLEMENTATION/RFC-0052/TESTS.md

@@ -0,0 +1 @@
+happy path

package/IMPLEMENTATION/RFC-0053/ACCEPTANCE_CRITERIA.md

@@ -0,0 +1,8 @@
+- Models can be registered and unregistered
+- Alias lookup works correctly
+- Filters return correctly filtered and sorted results
+- Cost calculation handles all pricing components
+- Default models are loaded on initialization
+- Status changes are tracked
+- Events are emitted for all operations
+- Unit tests cover all query scenarios

package/IMPLEMENTATION/RFC-0053/AI_BRIEF.md

@@ -0,0 +1,20 @@
+# AI Brief — Quota Manager (RFC-0053)
+
+**Status:** ✅ Done
+
+## Implemented
+
+- `packages/quota-manager/`
+- `QuotaManager`, `TUIUsageMonitor` classes
+- Multi-provider quota tracking and reset estimation
+
+## Features
+
+- Multi-provider quota tracking
+- Reset time estimation
+- TUI usage monitoring
+- Threshold alerts
+
+## Tests
+
+- 25 tests pass (added by subagent)

package/IMPLEMENTATION/RFC-0053/FILES.md

@@ -0,0 +1,9 @@
+packages/model-registry/src/index.ts
+packages/model-registry/src/types.ts
+packages/model-registry/src/registry.ts
+packages/model-registry/src/query.ts
+packages/model-registry/src/cost.ts
+packages/model-registry/src/defaults.ts
+packages/model-registry/test/registry.test.ts
+packages/model-registry/package.json
+packages/model-registry/tsconfig.json

package/IMPLEMENTATION/RFC-0053/TASKS.md

@@ -0,0 +1,3 @@
+Types
+Core
+Tests

package/IMPLEMENTATION/RFC-0053/TESTS.md

@@ -0,0 +1 @@
+happy path

package/IMPLEMENTATION/RFC-0054/ACCEPTANCE_CRITERIA.md

@@ -0,0 +1,8 @@
+- Routing respects task type and capabilities
+- Strategy selection works for all strategies
+- Cost and quota filters are applied correctly
+- Weighted scoring produces reasonable results
+- Fallback providers are used when needed
+- Events are emitted for all routing decisions
+- Unit tests cover all strategies and scenarios
+- Integration with Capability Registry and Model Registry works

package/IMPLEMENTATION/RFC-0054/AI_BRIEF.md

@@ -0,0 +1,19 @@
+# AI Brief — Runtime (RFC-0054)
+
+**Status:** ✅ Done
+
+## Implemented
+
+- `packages/runtime/`
+- `CommandExecutor`, `LocalRuntimeAgent`, `PolicyEngine`, `RuntimeAPI`, `WorkspaceManager`
+
+## Features
+
+- Local runtime agent execution
+- Command execution with sandboxing
+- Policy evaluation engine
+- Workspace management
+
+## Tests
+
+- 20 tests pass (added by subagent)

package/IMPLEMENTATION/RFC-0054/FILES.md

@@ -0,0 +1,8 @@
+packages/provider-router/src/provider-router.ts  # Enhanced
+packages/provider-router/src/types.ts
+packages/provider-router/src/strategies.ts
+packages/provider-router/src/policy.ts
+packages/provider-router/src/index.ts
+packages/provider-router/test/provider-router.test.ts
+packages/provider-router/package.json
+packages/provider-router/tsconfig.json

package/IMPLEMENTATION/RFC-0054/TASKS.md

@@ -0,0 +1,3 @@
+Types
+Core
+Tests

package/IMPLEMENTATION/RFC-0054/TESTS.md

@@ -0,0 +1 @@
+happy path

package/IMPLEMENTATION/RFC-0055/ACCEPTANCE_CRITERIA.md

@@ -0,0 +1,8 @@
+- Cost entries are tracked with full metadata
+- Budget status reflects current usage correctly
+- Forecast provides reasonable estimates
+- Model switch recommendations are sensible
+- Optimized selections are Pareto-optimal
+- Events are emitted for budget warnings and exhaustion
+- Unit tests cover all scenarios
+- Integration with Model Registry and Capability Registry works

package/IMPLEMENTATION/RFC-0055/AI_BRIEF.md

@@ -0,0 +1,17 @@
+# AI Brief — TUI (RFC-0055)
+
+**Status:** !️ Stub
+
+## Implemented
+
+- `packages/tui/`
+- No source files implemented yet — package is an empty scaffold
+
+## Planned
+
+- Terminal UI for pi-harness-runtime
+- Interactive command interface
+
+## Tests
+
+- None (no implementation yet)

package/IMPLEMENTATION/RFC-0055/FILES.md

@@ -0,0 +1,9 @@
+packages/cost-optimizer/src/index.ts
+packages/cost-optimizer/src/types.ts
+packages/cost-optimizer/src/tracker.ts
+packages/cost-optimizer/src/budget.ts
+packages/cost-optimizer/src/selection.ts
+packages/cost-optimizer/src/forecast.ts
+packages/cost-optimizer/test/cost-optimizer.test.ts
+packages/cost-optimizer/package.json
+packages/cost-optimizer/tsconfig.json

package/IMPLEMENTATION/RFC-0055/TASKS.md

@@ -0,0 +1,3 @@
+Types
+Core
+Tests

package/IMPLEMENTATION/RFC-0055/TESTS.md

@@ -0,0 +1 @@
+happy path