hive-lite 0.1.9 → 0.2.0

package/src/lib/map.js

@@ -317,6 +317,24 @@ function currentMapFilesSection(result) {
   return lines;
 }
 
+function fromFindRepairRequirements(findContext) {
+  if (!findContext) return [];
+  return [
+    'Map Repair Draft Requirements:',
+    '- Account for `readable_reference`: put old peer files, copy sources, examples, and comparison-only files here instead of Direct Writable.',
+    '- Account for `writable_existing`: use exact existing files for registry hooks, routers, indexes, config, or other required update targets.',
+    '- Account for `writable_create_patterns`: use narrow create patterns for every new artifact family the intent must create.',
+    '- Account for `artifact_families`: declare trigger terms, `create_requires`, and required hooks for repeated provider/adapter/endpoint families.',
+    '- Account for `identity_aliases`: map user-facing names, model names, and vendor nicknames to canonical peer identities when identity routing matters.',
+    '- Account for `peer_file_templates`: add read-only candidate path templates for repeated peer file families; do not treat them as write permission.',
+    '- Account for required hooks: if an artifact family needs an existing registry/router/index update, add exact `writable_existing` coverage for that hook.',
+    '- Explain why old peer or copy-source files remain reference-only when the intent creates or targets a different peer identity.',
+    '- Explain why the selected Direct Writable scope is narrow, relevant to this intent, operation-specific, and not review-gated.',
+    '- Do not fix a map gap by moving broad fallback patterns into `writable_direct`.',
+    '',
+  ];
+}
+
 function summarizeFindContext(context) {
   if (!context) return null;
   const scope = context.scope || {};
@@ -441,6 +459,11 @@ function repairFocusFromFind(findContext, userFocus) {
   if (warnings.includes('TARGET_ENTITY_MISMATCH')) goals.push('add direct scope for the requested target identity or mark old peers as references');
   if (warnings.includes('MISSING_ARTIFACT_FAMILY_SCOPE')) goals.push('add writable_create_patterns for required artifact families');
   if (warnings.includes('MISSING_REQUIRED_HOOK_SCOPE')) goals.push('add writable_existing hook files required by the artifact family');
+  if (warnings.includes('AMBIGUOUS_TARGET_IDENTITY')) goals.push('clarify the target identity so Direct Writable is selected for one intent target');
+  if (warnings.includes('REFERENCE_DIRECT_ROLE_CONFLICT')) goals.push('separate readable_reference peer examples from update-capable Direct Writable scope');
+  if (warnings.includes('DIRECT_SCOPE_OPERATION_UNSPECIFIED')) goals.push('declare operations under writable_existing or writable_create_patterns');
+  if (warnings.includes('UNKNOWN_NEW_FILE')) goals.push('add an exact or narrow create capability for the new file, or remove it from the diff');
+  if (warnings.includes('LOW_CONFIDENCE_INTENT_WRITE_PLAN')) goals.push('add artifact_families and narrow write capabilities for the inferred write operation');
   if (warnings.includes('MISSING_ENTRYPOINT')) goals.push('add durable entrypoints');
   if (warnings.includes('MISSING_VALIDATION')) goals.push('add validation profile references');
   if (warnings.includes('NO_CONFIDENT_AREA')) goals.push('create or refine a focused area');
@@ -481,6 +504,8 @@ function findContextPromptSection(findContext) {
       ...listLines(findContext.writePlan.blockingWarnings || [], (item) => `- ${item.code}: ${item.message}`),
       'Reference files from write plan:',
       ...listLines(findContext.writePlan.referenceFiles || [], (file) => `- ${file.path}: ${file.reason || ''}`),
+      'Peer file template candidates from write plan:',
+      ...listLines(findContext.writePlan.peerFileCandidates || [], (file) => `- ${file.artifact}: ${file.candidatePath || file.template} (read-only; not Direct Writable)`),
       '',
     ] : []),
     'Candidate/area scores:',
@@ -556,6 +581,19 @@ function buildMapPrompt(result) {
     '',
     ...fromFindTask,
     '',
+    ...fromFindRepairRequirements(result.findContext),
+    'Context Gathering:',
+    '- Use the repo evidence below first; inspect additional files only when needed to avoid guessing paths, scripts, or entrypoints.',
+    '- Stop once the map draft or repair can name exact paths, active validation profiles, and any TODO uncertainty.',
+    '- Mark uncertain paths, validation, or risk items as TODOs instead of continuing broad architecture exploration.',
+    '',
+    'Completion Contract:',
+    result.findContext
+      ? '- If editing-capable, finish by changing only the relevant `.hive/map/*.yaml` files and summarizing the exact map changes.'
+      : '- Finish with a concise Project Map draft, not an implementation plan.',
+    '- Do not include product-code edits or coding-agent instructions.',
+    '- Include verification commands needed for the human to confirm the map quality.',
+    '',
     'Boundaries:',
     '- Group areas by user intent or work area, not by a pure directory tree.',
     '- Do not invent nonexistent paths.',
@@ -572,6 +610,12 @@ function buildMapPrompt(result) {
     '- Prefer `writable_existing` for exact update targets and `writable_create_patterns` for new peer files when a repo has create/update distinctions.',
     '- Put copy sources and peer examples under `readable_reference`, not under selected Direct Writable for new peer intents.',
     '- Use `artifact_families` to declare required create artifacts and hook files for provider/adapter/endpoint families.',
+    '- Use `identity_aliases` when user-facing names such as ChatGPT, image2, or vendor nicknames should map to one canonical peer identity.',
+    '- Use `peer_file_templates` only as read-only candidate path hints; they never grant create or update permission.',
+    '- Relevant files, entrypoints, peer examples, and broad fallback scope are not write permission by themselves.',
+    '- Direct Writable is selected per intent; do not copy every writable file in an area into the selected edit target.',
+    '- For create intents, include narrow `writable_create_patterns` entries with `operations: [create_file]`, `artifact`, and `intent_kinds` when possible.',
+    '- For required existing hooks, include exact `writable_existing` entries with `operations: [update_existing]` and the hook artifact.',
     '- Entrypoint roles must use this fixed taxonomy only: ' + roleListText() + '.',
     '- Do not invent role names. If unsure, use `role: unknown` plus a TODO note.',
     '- Add `source` and `confidence` to entrypoints when possible. Use `source: agent_draft` for your own draft and `confidence: low|medium|high`.',
@@ -616,6 +660,19 @@ function buildMapPrompt(result) {
     '      - phrase users may say',
     '    concepts:',
     '      - concept keyword',
+    '    identity_aliases:',
+    '      openai:',
+    '        canonical: OpenAI',
+    '        aliases:',
+    '          - chatgpt',
+    '          - gpt-image',
+    '          - image2',
+    '    peer_file_templates:',
+    '      provider_proxy:',
+    '        target_slot: provider',
+    '        artifacts:',
+    '          service_impl: path/to/{Provider}Provider.ts',
+    '          request_dto: path/to/{Provider}Request.ts',
     '    entrypoints:',
     '      - path: path/to/real/file.ts',
     '        role: ui_component',