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

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

@@ -0,0 +1,190 @@
+{
+  "schemaVersion": "1.0.0",
+  "generatedAt": "2026-07-21T00:00:00.000Z",
+  "tool": { "name": "my-dev-kit", "version": "1.10.2" },
+  "request": {
+    "originalQuery": "Inspect task implementation and tests",
+    "normalizedQuery": "Inspect task implementation and tests",
+    "mode": "feature-add",
+    "requestedOutputPath": "Z:/fixture/project/.my-dev-kit/retrieval-audit-record.json",
+    "role": "implementation",
+    "requestFilePath": null
+  },
+  "index": {
+    "indexPath": "Z:/fixture/project/.my-dev-kit",
+    "manifestPath": "Z:/fixture/project/.my-dev-kit/manifest.json"
+  },
+  "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": []
+  },
+  "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": null,
+    "warnings": []
+  },
+  "truncation": {
+    "truncated": false,
+    "records": [],
+    "warnings": []
+  },
+  "fullFileFallback": {
+    "enabled": true,
+    "limit": null,
+    "used": 1,
+    "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": true,
+        "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/1.10.2/retrieval-audit-record/future-minor-v1.1.0-additive.json

@@ -0,0 +1,327 @@
+{
+  "schemaVersion": "1.1.0",
+  "generatedAt": "2026-07-21T00:00:00.000Z",
+  "tool": {
+    "name": "my-dev-kit",
+    "version": "1.10.2",
+    "futureNestedField": "preserved"
+  },
+  "request": {
+    "originalQuery": "Inspect task implementation and tests",
+    "normalizedQuery": "Inspect task implementation and tests",
+    "mode": "feature-add",
+    "requestedOutputPath": "Z:/fixture/project/.my-dev-kit/retrieval-audit-record.json",
+    "role": "implementation",
+    "requestFilePath": null
+  },
+  "index": {
+    "indexPath": "Z:/fixture/project/.my-dev-kit",
+    "manifestPath": "Z:/fixture/project/.my-dev-kit/manifest.json"
+  },
+  "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": []
+  },
+  "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": null,
+    "warnings": []
+  },
+  "truncation": {
+    "truncated": false,
+    "records": [],
+    "warnings": []
+  },
+  "fullFileFallback": {
+    "enabled": true,
+    "limit": null,
+    "used": 1,
+    "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": true,
+        "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"
+    }
+  ],
+  "futureMinorRootField": "preserved"
+}

package/tests/fixtures/upstream-artifacts/my-dev-kit-1.10.2-identity/PROVENANCE.txt

@@ -0,0 +1,13 @@
+Artifact source: real local my-dev-kit `context` command
+Producer package version: 1.10.2
+Producer CLI version: 1.10.2
+Producer branch: fix/v1.10.3-context-readiness
+Producer base commit: 9f1c7c5392e2dde9a1aae80e330134950e6e101f
+Producer final commit: e2d8c66075036824c8eeb5290b630979ab7cee79
+Context capsule schema version: 1.0.0
+Retrieval audit schema version: 1.0.0
+Source repository: Z:/Users/newuser/Projects/my-dev-kit-orchestrator
+Expected evaluator result: consistent
+Context capsule SHA-256: 2AA664F02A4830D0698FBF6D4C8203F99EE1EA420142EB58A5EDF284ED26EE66
+Retrieval audit SHA-256: 5D5B0129EC3FAF92F87AD58A846EECB930FE6DD2CE66C0D26F5F51CD08879585
+Copy policy: both JSON files are byte-for-byte copies and must not be hand-edited.