@open-mercato/cli 0.6.7-develop.6706.1.b3a4c759bb → 0.6.7-develop.6725.1.07a748cfc2

package/dist/agentic/shared/ai/skills/om-implement-spec/references/spec-resolution.md

@@ -0,0 +1,24 @@
+# Spec Resolution
+
+Resolve the user's reference before readiness analysis or planning. The first unambiguous match wins.
+
+1. **Path** — use an existing repository-relative Markdown file directly.
+2. **Name/title** — search the configured specs directory (`paths.specs`, default `.ai/specs`) case-insensitively by filename with or without its date prefix/extension, then by the document's first `# Title`. Use the newest dated file only when the title match is unambiguous.
+3. **Issue** — for a numeric reference and an available configured tracker, use its read-only issue operation and scan the body/comments for repository-relative spec paths. Do not mutate the issue.
+4. **Spec PR** — when the numeric issue lookup does not resolve a spec, use the tracker's read-only PR operation. Accept a spec path only when that file is already present locally. Do not fetch, check out, update, or implement on a spec PR branch; ask the user to materialize/merge it locally or use `om-auto-implement-spec` for PR delivery.
+
+Record the repository-relative path as `SPEC_PATH`. Validate that the file has an `## Implementation Plan` or `## Phasing` section. A found spec without one returns to `om-spec-writing` as not implementation-ready.
+
+If several candidates remain, stop and let the user select one. If no candidate exists, report:
+
+```text
+Status: blocked
+Spec not found for "{spec}".
+Searched: path, configured specs-directory name/title match, and read-only issue/spec-PR references when a tracker was available.
+Closest candidates:
+- {path} — {title}
+- …
+Next: pass an exact path, or create/revise the spec with om-spec-writing "{spec}".
+```
+
+This local resolver performs no tracker writes and makes no branch, commit, or PR claim.

package/dist/agentic/shared/ai/specs/README.md

@@ -24,4 +24,4 @@ Example: 2026-03-01-inventory-module.md
 1. Route every new application, multi-module feature, or non-trivial business slice through `om-spec-writing` and `.ai/guides/spec-delivery.md`.
 2. After invoking the skill, create the skeleton from `SPEC-000-template.md`; keep it `Draft` while blocking questions or incomplete contracts remain.
 3. Set `Ready for implementation` only after the final compliance report and requirement traceability pass and the user approves implementation.
-4. Implement through `om-implement-spec` (local) or `om-auto-implement-spec` (PR), one dependency-ordered phase at a time; update the Changelog, acceptance evidence, and phase state as work lands.
+4. Implement through `om-implement-spec` (interactive local) or `om-auto-implement-spec` (whole-spec PR), one dependency-ordered phase at a time; update the Changelog, acceptance evidence, and phase state as work lands. Local delivery confirms its phase-derived plan before coding and ends with the stable `Spec:` reference without implying PR automation.

package/dist/agentic/shared/scripts/evaluate-agent-harness.mjs

@@ -447,6 +447,24 @@ function validateCatalog({ root, cases, registry, releaseMatrix, fixtures, seeds
     if (!Number.isInteger(item.maxContextFiles) || item.maxContextFiles < requiredInitialContextFiles || item.maxContextFiles > registry.catalog.maxContextFiles) add(id, 'maxContextFiles is impossible or excessive')
     if (!Number.isInteger(item.maxInitialContextBytes) || item.maxInitialContextBytes < 4096 || item.maxInitialContextBytes > registry.catalog.maxInitialContextBytes) add(id, 'maxInitialContextBytes is invalid')
     if (!Number.isInteger(item.maxTotalContextBytes) || item.maxTotalContextBytes < item.maxInitialContextBytes || item.maxTotalContextBytes > registry.catalog.maxTotalContextBytes) add(id, 'maxTotalContextBytes is invalid')
+    // A case must be satisfiable against the assets this app actually ships: an agent that
+    // reads exactly what the case requires, or exactly what it declares, can never be failed
+    // by that case's own budget. Measured from disk, so a grown guide or fact-sheet surfaces
+    // here instead of as a live routing failure that looks like a model mistake.
+    if (Number.isInteger(item.maxContextFiles) && Number.isInteger(item.maxInitialContextBytes) && Number.isInteger(item.maxTotalContextBytes)) {
+      const required = contextStats(root, item.context?.required ?? [])
+      const declared = contextStats(root, [...(item.context?.required ?? []), ...(item.context?.allowedExtra ?? [])])
+      // `required` is a guaranteed false negative and `declared` only a latent one, so each
+      // budget reports the sharper of the two rather than both.
+      for (const [measure, limit, budget] of [
+        ['initialBytes', item.maxInitialContextBytes, 'maxInitialContextBytes'],
+        ['bytes', item.maxTotalContextBytes, 'maxTotalContextBytes'],
+        ['initialFiles', item.maxContextFiles, 'maxContextFiles'],
+      ]) {
+        if (required[measure] > limit) add(id, `required context exceeds ${budget}: ${required[measure]}/${limit}`)
+        else if (declared[measure] > limit) add(id, `declared context exceeds ${budget}: ${declared[measure]}/${limit}`)
+      }
+    }
     if (!isUniqueStringArray(item.relatedCases, { min: 1 })) add(id, 'relatedCases must not be empty')
     for (const related of item.relatedCases ?? []) if (!idSet.has(related)) add(id, `dangling related case ${related}`)
     const writable = WRITABLE_KINDS.has(item.evaluationKind)

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@open-mercato/cli",
-  "version": "0.6.7-develop.6706.1.b3a4c759bb",
+  "version": "0.6.7-develop.6725.1.07a748cfc2",
   "license": "MIT",
   "type": "module",
   "main": "./dist/index.js",
@@ -60,8 +60,8 @@
     "@mikro-orm/decorators": "^7.1.5",
     "@mikro-orm/migrations": "^7.1.5",
     "@mikro-orm/postgresql": "^7.1.5",
-    "@open-mercato/queue": "0.6.7-develop.6706.1.b3a4c759bb",
-    "@open-mercato/shared": "0.6.7-develop.6706.1.b3a4c759bb",
+    "@open-mercato/queue": "0.6.7-develop.6725.1.07a748cfc2",
+    "@open-mercato/shared": "0.6.7-develop.6725.1.07a748cfc2",
     "cross-spawn": "^7.0.6",
     "pg": "8.22.0",
     "semver": "^7.8.5",
@@ -72,10 +72,10 @@
     "typescript-js": "npm:typescript@6.0.3"
   },
   "peerDependencies": {
-    "@open-mercato/shared": "0.6.7-develop.6706.1.b3a4c759bb"
+    "@open-mercato/shared": "0.6.7-develop.6725.1.07a748cfc2"
   },
   "devDependencies": {
-    "@open-mercato/shared": "0.6.7-develop.6706.1.b3a4c759bb",
+    "@open-mercato/shared": "0.6.7-develop.6725.1.07a748cfc2",
     "@types/jest": "^30.0.0",
     "jest": "^30.4.2",
     "ts-jest": "^29.4.11"