@dailephd/my-dev-kit-lab 0.4.4 → 0.4.5

package/tests/fixtures/upstream-artifacts/my-dev-kit/1.10.4/retrieval-audit-record/complete-v1.0.0.json

@@ -0,0 +1,238 @@
+{
+  "schemaVersion": "1.0.0",
+  "generatedAt": "2026-07-31T00:00:00.000Z",
+  "tool": { "name": "my-dev-kit", "version": "1.10.4" },
+  "request": {
+    "originalQuery": "Inspect task implementation and tests",
+    "normalizedQuery": "Inspect task implementation and tests",
+    "mode": "feature-add",
+    "requestedOutputPath": "Z:/fixture/project/.my-dev-kit/context-capsule.json",
+    "role": "implementation",
+    "requestFilePath": null
+  },
+  "index": {
+    "indexPath": "Z:/fixture/project/.my-dev-kit",
+    "manifestPath": "Z:/fixture/project/.my-dev-kit/manifest.json",
+    "manifestSchemaVersion": "1.0.0",
+    "projectRoot": "Z:/fixture/project"
+  },
+  "steps": [
+    {
+      "id": "fixture.step.001",
+      "kind": "validate-inputs",
+      "description": "Validate CLI inputs.",
+      "inputs": { "query": "Inspect task implementation and tests", "mode": "feature-add", "role": "implementation", "notes": null },
+      "outputs": { "valid": true, "warningCount": 0 },
+      "status": "ok",
+      "warnings": []
+    },
+    {
+      "id": "fixture.step.002",
+      "kind": "run-search",
+      "description": "Run search against the index.",
+      "inputs": { "query": "Inspect task implementation and tests" },
+      "outputs": { "resultCount": 1, "topScore": 12.5 },
+      "status": "ok",
+      "warnings": []
+    },
+    {
+      "id": "fixture.step.003",
+      "kind": "use-local-source-expansion",
+      "description": "Attempted local source expansion.",
+      "inputs": { "focusNodeId": "symbol:src/example.ts#Example" },
+      "outputs": { "used": false },
+      "status": "skipped",
+      "warnings": ["local expansion not required"]
+    }
+  ],
+  "fallbacks": [],
+  "fullFileReadRecommendations": [
+    {
+      "filePath": "src/other.ts",
+      "reason": "bounded retrieval insufficient",
+      "missingContext": "full implementation detail",
+      "continuationOrExpansionAttempted": true
+    },
+    {
+      "filePath": "src/legacy.ts",
+      "reason": "continuation could not be attempted",
+      "missingContext": "legacy behavior detail",
+      "continuationOrExpansionAttempted": "unavailable"
+    }
+  ],
+  "warnings": ["Fixture warning: synthetic data only."],
+  "contextAdequacy": {
+    "status": "context sufficient with listed assumptions",
+    "summary": "A best-effort focus node was selected; some ambiguity or thin graph/source/metadata evidence remains.",
+    "assumptions": ["Fixture assumption."],
+    "gaps": ["Fixture gap."]
+  },
+  "roleContext": {
+    "role": "implementation",
+    "focus": {
+      "focusFiles": [{ "path": "src/example.ts", "resolved": true, "matchedFilePaths": ["src/example.ts"], "containedSymbolIds": ["symbol:src/example.ts#Example"] }],
+      "focusSymbols": [{ "symbol": "Example", "resolved": true, "ambiguous": false, "matchedNodeIds": ["symbol:src/example.ts#Example"] }],
+      "unresolvedFocusFiles": [],
+      "unresolvedFocusSymbols": [],
+      "ambiguousFocusSymbols": [],
+      "warnings": []
+    },
+    "changedSurface": {
+      "available": true,
+      "diffRequested": true,
+      "files": [{ "path": "src/example.ts", "status": "modified", "provenance": "both" }],
+      "symbols": [{ "symbolId": "symbol:src/example.ts#Example", "status": "modified", "provenance": "graph-diff", "filePath": "src/example.ts", "name": "Example", "kind": "symbol" }],
+      "conflicts": [],
+      "warnings": []
+    },
+    "requestedEvidenceKinds": ["owner", "dependencies"],
+    "unsupportedRequestedEvidenceKinds": ["responsibility-mappings"],
+    "warnings": []
+  },
+  "roleConditionCoverage": [
+    {
+      "conditionId": "implementation.selected-owner",
+      "role": "implementation",
+      "required": true,
+      "evidenceGroupIds": ["implementation-owners"],
+      "witnessPolicy": "at-least-one",
+      "requiredWitnessCount": 1,
+      "availableWitnessCount": 1,
+      "retainedWitnessCount": 1,
+      "retainedWitnessIds": ["src/example.ts"],
+      "conditionSatisfied": true,
+      "lostRequiredCondition": false,
+      "lossReason": null,
+      "evaluationOrder": 10
+    },
+    {
+      "conditionId": "implementation.required-contract",
+      "role": "implementation",
+      "required": true,
+      "evidenceGroupIds": ["implementation-contracts"],
+      "witnessPolicy": "at-least-one",
+      "requiredWitnessCount": 1,
+      "availableWitnessCount": 0,
+      "retainedWitnessCount": 0,
+      "retainedWitnessIds": [],
+      "conditionSatisfied": false,
+      "lostRequiredCondition": false,
+      "lossReason": null,
+      "evaluationOrder": 20
+    }
+  ],
+  "responsibilityMappings": {
+    "requested": true,
+    "operational": true,
+    "mappings": [
+      {
+        "responsibilityId": "fixture.responsibility.001",
+        "behavior": "Example behaves correctly.",
+        "invariant": null,
+        "criticality": "critical",
+        "productionSymbols": [{ "id": "symbol:src/example.ts#Example", "itemKind": "symbol", "symbolId": "symbol:src/example.ts#Example", "relationship": "production-symbol", "basis": "candidate-ranking", "provenance": "candidate-ranking" }],
+        "contracts": [],
+        "validators": [],
+        "constants": [],
+        "errors": [],
+        "sideEffectEvidence": [],
+        "proposedOrExistingTestFiles": [{ "id": "tests/example.spec.ts", "itemKind": "test-file", "path": "tests/example.spec.ts", "relationship": "proposed-test", "basis": "path-proximity", "provenance": "test-directory-walk" }],
+        "reusableHelpers": [],
+        "oracleEvidence": [],
+        "testCommands": [],
+        "mappingStatus": "mapped",
+        "unresolvedReasons": [],
+        "provenance": [
+          { "id": "fixture.provenance.mapping.001", "category": "code-graph", "sourcePath": "src/example.ts", "sourceId": null, "evidenceId": "symbol:src/example.ts#Example", "relationshipBasis": "candidate-ranking", "role": "implementation", "requestField": null, "derivedByModule": "responsibilityMapping.ts" }
+        ],
+        "warnings": []
+      }
+    ],
+    "unknownResponsibilityIds": [],
+    "duplicateResponsibilityIds": [],
+    "limit": null,
+    "availableCount": 1,
+    "usedCount": 1,
+    "truncated": false,
+    "droppedCount": 0,
+    "criticalDropped": false,
+    "warnings": []
+  },
+  "roleAdequacy": {
+    "role": "implementation",
+    "status": "context sufficient with listed assumptions",
+    "requiredConditions": ["single high-confidence focus node"],
+    "satisfiedConditions": ["single high-confidence focus node"],
+    "missingConditions": [],
+    "blockingConditions": [],
+    "warnings": [],
+    "supportingEvidence": ["symbol:src/example.ts#Example"],
+    "affectedResponsibilityIds": ["fixture.responsibility.001"],
+    "truncationImpact": false,
+    "freshnessImpact": false
+  },
+  "freshness": {
+    "state": "fresh",
+    "role": "implementation",
+    "evidenceUsed": ["code-graph"],
+    "evidenceUnavailable": ["before-index"],
+    "comparedIdentities": [
+      { "label": "index-manifest-hash", "value": "fixture-hash-001" },
+      { "label": "before-index-manifest-hash", "value": null }
+    ],
+    "reason": "Active index manifest hash matches the most recent recorded identity.",
+    "relevantChangedPaths": ["src/example.ts"],
+    "warnings": []
+  },
+  "budget": {
+    "limits": [
+      { "name": "candidates", "declaredValue": 50, "usedValue": 1, "availableCount": 49, "droppedCount": 0, "truncated": false, "requiredEvidenceAffected": false, "adequacyImpact": null }
+    ],
+    "characters": { "measured": 1200, "limit": 8000, "truncated": false },
+    "warnings": []
+  },
+  "truncation": {
+    "truncated": false,
+    "requiredEvidenceLost": false,
+    "records": [
+      {
+        "id": "fixture.truncation.001",
+        "affectedGroup": "implementation-owners",
+        "limit": 10,
+        "used": 1,
+        "available": 1,
+        "droppedCount": 0,
+        "droppedEvidenceIds": [],
+        "requiredEvidenceLost": false,
+        "adequacyImpact": null,
+        "reason": "within declared limit"
+      }
+    ],
+    "warnings": []
+  },
+  "fullFileFallback": {
+    "enabled": true,
+    "limit": null,
+    "used": 0,
+    "fallbacks": [
+      {
+        "id": "fixture.fallback.001",
+        "filePath": "src/other.ts",
+        "reason": "bounded retrieval insufficient",
+        "requestedEvidenceKind": null,
+        "boundedRetrievalAttempted": true,
+        "sourceRangesAttempted": 2,
+        "includedLineCount": 40,
+        "includedCharacterCount": 900,
+        "role": "implementation",
+        "responsibilityIdsAffected": [],
+        "allowed": false,
+        "provenance": "full-file-fallback"
+      }
+    ],
+    "warnings": []
+  },
+  "provenance": [
+    { "id": "fixture.provenance.001", "category": "code-graph", "sourcePath": "src/example.ts", "sourceId": null, "evidenceId": "symbol:src/example.ts#Example", "relationshipBasis": "candidate-ranking", "role": "implementation", "requestField": null, "derivedByModule": "candidateRanking.ts" }
+  ]
+}

package/tests/fixtures/upstream-artifacts/my-dev-kit-orchestrator/1.2.3/run-integrity/PROVENANCE.txt

@@ -0,0 +1,31 @@
+Artifact source: hand-built fixtures derived from the local my-dev-kit-orchestrator v1.2.3
+readiness-candidate run-integrity contract (not a byte-for-byte real-run capture; the
+orchestrator computes these as in-memory TypeScript results plus one real JSON file
+[artifact-state.json record shape], not one combined JSON artifact -- this fixture bundles
+them under one lab-owned envelope per Batch 3 section 14.1).
+Producer repository: Z:/Users/newuser/Projects/my-dev-kit-orchestrator
+Producer branch: fix/v1.2.3-run-integrity
+Producer candidate commit: 2cb82f09ed423be8defd8277f28608c8a17eae3e
+Producer contract files inspected: src/runIntegrityGate.ts, src/judgeIntegrity.ts,
+src/artifactLifecycle.ts, src/correctionRouter.ts, src/judgeParser.ts
+Bundled schema versions: RUN_INTEGRITY_GATE_SCHEMA_VERSION "1.0.0",
+JUDGE_INTEGRITY_SCHEMA_VERSION "1.0.0" (both reused for the envelope's own "schemaVersion").
+Nested implementationContext/testContext/primaryBlocker reuse the exact upstream
+ContextReadinessResult / ContextReadinessBlockerSummary shape already mirrored by Batch 1's
+orchestratorContextReadinessResultV1.ts -- validated through the existing
+validateOrchestratorContextReadinessResultV1() rather than a second reader.
+
+Fixtures in this directory:
+- ready-pass-final-pass.json: the "everything agrees" positive chain (section 29.1) --
+  producer/readiness ready, prompt normal (implied by contextReady + no blockedStageNames),
+  expected/actual judge PASS, no correction route, final-report eligible/present/PASS,
+  lifecycle all complete.
+- refresh-required-need-context.json: the "correctly blocked" positive chain (section 29.2)
+  -- readiness refresh-required, expected/actual judge NEED_CONTEXT, correction route active
+  to the canonical recommended stage, final report ineligible/absent, implementation stage
+  lifecycle forced to "blocked" by the gate.
+
+Copy policy: hand-authored fixtures; edit directly when the mirrored contract changes, and
+update this file's "Producer contract files inspected" list to match. These are bounded
+Batch 3 contract fixtures, not the complete Batch 4 frozen ecosystem regression fixture (no
+hash manifest, no byte-exact real-run provenance, no full negative matrix).

package/tests/fixtures/upstream-artifacts/my-dev-kit-orchestrator/1.2.3/run-integrity/ready-pass-final-pass.json

@@ -0,0 +1,132 @@
+{
+  "schemaVersion": "1.0.0",
+  "runFolder": "Z:/fixture/project/.my-dev-kit-orchestrator/runs/run-fixture-001",
+  "gate": {
+    "schemaVersion": "1.0.0",
+    "mode": "feature",
+    "contextRequired": true,
+    "applicableContextKinds": ["implementation", "test"],
+    "implementationContext": {
+      "schemaVersion": "1.0.0",
+      "kind": "implementation",
+      "role": "implementation",
+      "decision": "ready",
+      "classification": "ready",
+      "stageId": "stage.feature.implementation",
+      "packetPath": "artifacts/implementation-context-packet.txt",
+      "reportPath": "reports/implementation-context-retrieval-report.txt",
+      "issues": [],
+      "warnings": [],
+      "blockingIssueCodes": [],
+      "affectedResponsibilityIds": [],
+      "evaluatedFreshness": "fresh",
+      "evaluatedAdequacy": "sufficient",
+      "requiredEvidenceTruncated": "no",
+      "readyWithAssumptions": false,
+      "provenanceSummary": "resolved from populated packet/report pair",
+      "indexIdentity": "Z:/fixture/project"
+    },
+    "testContext": {
+      "schemaVersion": "1.0.0",
+      "kind": "test",
+      "role": "test-implementation",
+      "decision": "ready",
+      "classification": "ready",
+      "stageId": "stage.feature.test-implementation",
+      "packetPath": "artifacts/test-context-packet.txt",
+      "reportPath": "reports/test-context-retrieval-report.txt",
+      "issues": [],
+      "warnings": [],
+      "blockingIssueCodes": [],
+      "affectedResponsibilityIds": [],
+      "evaluatedFreshness": "fresh",
+      "evaluatedAdequacy": "sufficient",
+      "requiredEvidenceTruncated": "no",
+      "readyWithAssumptions": false,
+      "provenanceSummary": "resolved from populated packet/report pair",
+      "indexIdentity": "Z:/fixture/project"
+    },
+    "contextReady": true,
+    "readinessClassification": "ready",
+    "blockedStageNames": [],
+    "blockingCodes": [],
+    "recommendedCorrectionStage": null,
+    "expectedJudgeVerdict": "PASS",
+    "warnings": []
+  },
+  "judgeIntegrity": {
+    "schemaVersion": "1.0.0",
+    "judgeArtifactPresent": true,
+    "judgeVerdictParseStatus": "parsed",
+    "authoredJudgeVerdict": "PASS",
+    "expectedJudgeVerdict": "PASS",
+    "judgeVerdictMatchesExpected": true,
+    "judgeVerdictAccepted": true,
+    "correctionRequired": false,
+    "correctionBlocked": false,
+    "acceptedCorrectionStage": null,
+    "finalReportEligible": true,
+    "blockingCodes": [],
+    "acceptedCorrectionRoute": null
+  },
+  "finalReportEligibility": {
+    "eligible": true,
+    "contextReady": true,
+    "priorArtifactsValid": true,
+    "judgeIntegrity": {
+      "schemaVersion": "1.0.0",
+      "judgeArtifactPresent": true,
+      "judgeVerdictParseStatus": "parsed",
+      "authoredJudgeVerdict": "PASS",
+      "expectedJudgeVerdict": "PASS",
+      "judgeVerdictMatchesExpected": true,
+      "judgeVerdictAccepted": true,
+      "correctionRequired": false,
+      "correctionBlocked": false,
+      "acceptedCorrectionStage": null,
+      "finalReportEligible": true,
+      "blockingCodes": [],
+      "acceptedCorrectionRoute": null
+    },
+    "blockingCodes": []
+  },
+  "finalArtifactPresent": true,
+  "finalArtifactVerdict": "PASS",
+  "lifecycle": [
+    {
+      "artifactFile": "artifacts/architecture-context.txt",
+      "stageName": "architecture-context",
+      "fileExists": true,
+      "manualRecord": null,
+      "resolvedState": "complete"
+    },
+    {
+      "artifactFile": "artifacts/implementation.txt",
+      "stageName": "implementation",
+      "fileExists": true,
+      "manualRecord": null,
+      "resolvedState": "complete"
+    },
+    {
+      "artifactFile": "artifacts/test-implementation.txt",
+      "stageName": "test-implementation",
+      "fileExists": true,
+      "manualRecord": null,
+      "resolvedState": "complete"
+    },
+    {
+      "artifactFile": "artifacts/verification.txt",
+      "stageName": "verification",
+      "fileExists": true,
+      "manualRecord": { "state": "complete", "updatedAt": "2026-07-31T00:00:00.000Z", "source": "cli" },
+      "resolvedState": "complete"
+    },
+    {
+      "artifactFile": "artifacts/final-report.txt",
+      "stageName": "final-report",
+      "fileExists": true,
+      "manualRecord": null,
+      "resolvedState": "complete"
+    }
+  ]
+}

package/tests/fixtures/upstream-artifacts/my-dev-kit-orchestrator/1.2.3/run-integrity/refresh-required-need-context.json

@@ -0,0 +1,146 @@
+{
+  "schemaVersion": "1.0.0",
+  "runFolder": "Z:/fixture/project/.my-dev-kit-orchestrator/runs/run-fixture-002",
+  "gate": {
+    "schemaVersion": "1.0.0",
+    "mode": "feature",
+    "contextRequired": true,
+    "applicableContextKinds": ["implementation", "test"],
+    "implementationContext": {
+      "schemaVersion": "1.0.0",
+      "kind": "implementation",
+      "role": "implementation",
+      "decision": "refresh-required",
+      "classification": "required-evidence-truncated",
+      "stageId": "stage.feature.implementation",
+      "packetPath": "artifacts/implementation-context-packet.txt",
+      "reportPath": "reports/implementation-context-retrieval-report.txt",
+      "issues": [],
+      "warnings": [],
+      "blockingIssueCodes": ["CONTEXT_REQUIRED_EVIDENCE_TRUNCATED"],
+      "primaryIssue": {
+        "code": "CONTEXT_REQUIRED_EVIDENCE_TRUNCATED",
+        "severity": "error",
+        "message": "Required implementation evidence was truncated.",
+        "priority": 1,
+        "correctiveAction": "Refresh implementation context.",
+        "evidenceTarget": "implementation-context-packet",
+        "stageId": "stage.feature.implementation",
+        "contextKind": "implementation"
+      },
+      "blockerSummary": {
+        "contextKind": "implementation",
+        "primaryCode": "CONTEXT_REQUIRED_EVIDENCE_TRUNCATED",
+        "primaryReason": "Required implementation evidence was truncated.",
+        "correctiveAction": "Refresh implementation context.",
+        "evidenceTarget": "implementation-context-packet",
+        "blockingIssueCodes": ["CONTEXT_REQUIRED_EVIDENCE_TRUNCATED"],
+        "supportingIssueCodes": []
+      },
+      "affectedResponsibilityIds": [],
+      "evaluatedFreshness": "fresh",
+      "evaluatedAdequacy": "insufficient",
+      "requiredEvidenceTruncated": "yes",
+      "readyWithAssumptions": false,
+      "provenanceSummary": "resolved from populated packet/report pair",
+      "indexIdentity": "Z:/fixture/project"
+    },
+    "contextReady": false,
+    "readinessClassification": "refresh-required",
+    "blockedStageNames": ["implementation"],
+    "blockingCodes": ["CONTEXT_REQUIRED_EVIDENCE_TRUNCATED"],
+    "primaryBlocker": {
+      "contextKind": "implementation",
+      "primaryCode": "CONTEXT_REQUIRED_EVIDENCE_TRUNCATED",
+      "primaryReason": "Required implementation evidence was truncated.",
+      "correctiveAction": "Refresh implementation context.",
+      "evidenceTarget": "implementation-context-packet",
+      "blockingIssueCodes": ["CONTEXT_REQUIRED_EVIDENCE_TRUNCATED"],
+      "supportingIssueCodes": []
+    },
+    "recommendedCorrectionStage": "implementation",
+    "expectedJudgeVerdict": "NEED_CONTEXT",
+    "warnings": []
+  },
+  "judgeIntegrity": {
+    "schemaVersion": "1.0.0",
+    "judgeArtifactPresent": true,
+    "judgeVerdictParseStatus": "parsed",
+    "authoredJudgeVerdict": "NEED_CONTEXT",
+    "expectedJudgeVerdict": "NEED_CONTEXT",
+    "judgeVerdictMatchesExpected": true,
+    "judgeVerdictAccepted": true,
+    "correctionRequired": true,
+    "correctionBlocked": false,
+    "acceptedCorrectionStage": "implementation",
+    "finalReportEligible": false,
+    "blockingCodes": [],
+    "acceptedCorrectionRoute": {
+      "verdict": "NEED_CONTEXT",
+      "recommendedStage": "implementation",
+      "routedStage": "implementation",
+      "routeStatus": "correction_required",
+      "warnings": [],
+      "errors": [],
+      "isBlocked": false,
+      "strictFail": false
+    }
+  },
+  "finalReportEligibility": {
+    "eligible": false,
+    "contextReady": false,
+    "priorArtifactsValid": false,
+    "judgeIntegrity": {
+      "schemaVersion": "1.0.0",
+      "judgeArtifactPresent": true,
+      "judgeVerdictParseStatus": "parsed",
+      "authoredJudgeVerdict": "NEED_CONTEXT",
+      "expectedJudgeVerdict": "NEED_CONTEXT",
+      "judgeVerdictMatchesExpected": true,
+      "judgeVerdictAccepted": true,
+      "correctionRequired": true,
+      "correctionBlocked": false,
+      "acceptedCorrectionStage": "implementation",
+      "finalReportEligible": false,
+      "blockingCodes": [],
+      "acceptedCorrectionRoute": {
+        "verdict": "NEED_CONTEXT",
+        "recommendedStage": "implementation",
+        "routedStage": "implementation",
+        "routeStatus": "correction_required",
+        "warnings": [],
+        "errors": [],
+        "isBlocked": false,
+        "strictFail": false
+      }
+    },
+    "blockingCodes": ["FINAL_REPORT_PRIOR_ARTIFACTS_INCOMPLETE"],
+    "primaryReason": "A required prior native artifact is not yet complete."
+  },
+  "finalArtifactPresent": false,
+  "finalArtifactVerdict": null,
+  "lifecycle": [
+    {
+      "artifactFile": "artifacts/architecture-context.txt",
+      "stageName": "architecture-context",
+      "fileExists": true,
+      "manualRecord": null,
+      "resolvedState": "complete"
+    },
+    {
+      "artifactFile": "artifacts/implementation.txt",
+      "stageName": "implementation",
+      "fileExists": true,
+      "manualRecord": null,
+      "resolvedState": "blocked",
+      "blockingReason": "Required implementation evidence was truncated."
+    },
+    {
+      "artifactFile": "artifacts/final-report.txt",
+      "stageName": "final-report",
+      "fileExists": false,
+      "manualRecord": null,
+      "resolvedState": "missing"
+    }
+  ]
+}