snipara-companion 3.0.9 → 3.0.10

package/dist/index.js

@@ -9750,15 +9750,15 @@ function parseEnvLine(line) {
     return null;
   }
   const withoutExport = withoutWhitespace.startsWith("export ") ? withoutWhitespace.slice("export ".length).trim() : withoutWhitespace;
-  const separatorIndex = withoutExport.indexOf("=");
-  if (separatorIndex <= 0) {
+  const separatorIndex2 = withoutExport.indexOf("=");
+  if (separatorIndex2 <= 0) {
     return null;
   }
-  const key = withoutExport.slice(0, separatorIndex).trim();
+  const key = withoutExport.slice(0, separatorIndex2).trim();
   if (!/^[A-Za-z_][A-Za-z0-9_]*$/.test(key)) {
     return null;
   }
-  const value = parseEnvValue(withoutExport.slice(separatorIndex + 1).trim());
+  const value = parseEnvValue(withoutExport.slice(separatorIndex2 + 1).trim());
   return { key, value };
 }
 function parseEnvValue(rawValue) {
@@ -19782,7 +19782,15 @@ function decisionText(decision) {
     decision.decision,
     decision.rationale,
     decision.scope,
-    ...decision.constraints ?? []
+    decision.owner,
+    ...decision.constraints ?? [],
+    ...decision.antiGoals ?? [],
+    ...decision.rejectedAlternatives ?? [],
+    decision.intent?.goal,
+    decision.intent?.owner,
+    ...decision.intent?.constraints ?? [],
+    ...decision.intent?.antiGoals ?? [],
+    ...decision.intent?.rejectedAlternatives ?? []
   ].filter(Boolean).join(" ");
 }
 function confidenceBand(score) {
@@ -19805,26 +19813,73 @@ function surfaceFiles(surface, changedFiles) {
 
 // ../project-intelligence-contracts/src/intent-ledger.ts
 var PROJECT_INTENT_LEDGER_VERSION = "intent-ledger-v1";
-var PROJECT_INTENT_LEDGER_FRESHNESS_HORIZON_DAYS = 90;
-var DECISION_STATUS_RULES = [
-  { status: "contradicted", patterns: [/contradict/i, /conflict/i] },
-  { status: "superseded", patterns: [/supersed/i, /replac/i] },
-  { status: "stale", patterns: [/stale/i, /expired/i, /deprecated/i] },
-  { status: "approved", patterns: [/approved/i, /accepted/i, /active/i, /confirmed/i] }
-];
-var INTENT_PHRASE_SPLIT_PATTERN = /[;\n]/g;
-var INTENT_MARKDOWN_LIST_MARKER_PATTERN = /^[-*]\s*/;
-var INTENT_NUMBERED_LIST_MARKER_PATTERN = /^\d+\.\s*/;
-var INTENT_TEXT_EXTRACTORS = {
-  antiGoals: [/\b(?:avoid|forbid|prevent|do not|don't)\b[^.;\n]*/gi],
-  rejectedAlternatives: [/\b(?:rejected|instead of|rather than|not use|not using)\b[^.;\n]*/gi]
+var PROJECT_INTENT_LEDGER_DEFAULT_FRESHNESS_HORIZON_DAYS = 90;
+var DEFAULT_PROJECT_INTENT_LEDGER_POLICY = {
+  freshnessHorizonDays: PROJECT_INTENT_LEDGER_DEFAULT_FRESHNESS_HORIZON_DAYS
 };
-function intentStatusFromDecision(decision) {
-  const status = normalizeText(decision.status);
-  const matchedRule = DECISION_STATUS_RULES.find(
-    (rule) => rule.patterns.some((pattern) => pattern.test(status))
-  );
-  return matchedRule?.status ?? "review_pending";
+var DECISION_STATUS_ALIASES = {
+  approved: ["approved", "accepted", "active", "confirmed"],
+  review_pending: ["review_pending", "pending_review", "pending", "candidate", "draft"],
+  stale: ["stale", "expired", "deprecated"],
+  superseded: ["superseded", "replaced", "overridden"],
+  contradicted: ["contradicted", "conflicted", "conflict"]
+};
+var INTENT_SECTION_ALIASES = {
+  goal: ["goal", "intent", "why", "purpose", "rationale"],
+  constraints: ["constraint", "constraints", "rule", "rules", "must"],
+  antiGoals: ["anti_goal", "anti_goals", "avoid", "forbidden", "do_not"],
+  rejectedAlternatives: [
+    "rejected_alternative",
+    "rejected_alternatives",
+    "rejected",
+    "not_chosen",
+    "alternative_rejected",
+    "alternatives_rejected"
+  ],
+  owner: ["owner", "owners"],
+  freshnessHorizonDays: ["freshness_horizon_days", "horizon_days", "staleness_horizon_days"]
+};
+var INTENT_DOCUMENT_KIND_TOKENS = [
+  "adr",
+  "decision",
+  "intent",
+  "rationale",
+  "constraint",
+  "architecture",
+  "runbook"
+];
+function normalizeIdentifier(value) {
+  const normalized = [];
+  let previousWasSeparator = false;
+  for (const char of value?.trim().toLowerCase() ?? "") {
+    const code2 = char.charCodeAt(0);
+    const isAlphaNumeric = code2 >= 48 && code2 <= 57 || code2 >= 97 && code2 <= 122;
+    if (isAlphaNumeric) {
+      normalized.push(char);
+      previousWasSeparator = false;
+      continue;
+    }
+    if (!previousWasSeparator && normalized.length > 0) {
+      normalized.push("_");
+      previousWasSeparator = true;
+    }
+  }
+  if (normalized[normalized.length - 1] === "_") normalized.pop();
+  return normalized.join("");
+}
+function statusFromDecisionStatus(decision) {
+  const status = normalizeIdentifier(decision.status);
+  if (!status) return "review_pending";
+  for (const [ledgerStatus, aliases] of Object.entries(DECISION_STATUS_ALIASES)) {
+    if (aliases.includes(status)) return ledgerStatus;
+  }
+  const statusParts = status.split("_").filter(Boolean);
+  for (const [ledgerStatus, aliases] of Object.entries(DECISION_STATUS_ALIASES)) {
+    if (aliases.some((alias) => statusParts.includes(alias))) {
+      return ledgerStatus;
+    }
+  }
+  return "review_pending";
 }
 function intentConfidence(score, status, reasonCodes) {
   return {
@@ -19834,7 +19889,14 @@ function intentConfidence(score, status, reasonCodes) {
     reasonCodes
   };
 }
-function stalenessFromStatus(status) {
+function normalizeFreshnessHorizonDays(value) {
+  if (typeof value !== "number" || !Number.isFinite(value) || value <= 0) return null;
+  return Math.round(value);
+}
+function resolveFreshnessHorizonDays(specificValue, policy) {
+  return normalizeFreshnessHorizonDays(specificValue) ?? normalizeFreshnessHorizonDays(policy.freshnessHorizonDays) ?? null;
+}
+function stalenessFromStatus(status, freshnessHorizonDays) {
   if (status === "stale" || status === "superseded") {
     return {
       state: "stale",
@@ -19847,7 +19909,11 @@ function stalenessFromStatus(status) {
       reason: "The intent has not been reviewed as current project truth."
     };
   }
-  return { state: "fresh", horizonDays: PROJECT_INTENT_LEDGER_FRESHNESS_HORIZON_DAYS };
+  return {
+    state: "fresh",
+    horizonDays: freshnessHorizonDays,
+    reason: freshnessHorizonDays === null ? "No freshness horizon was supplied by source metadata or policy." : null
+  };
 }
 function intentEntryMatchesFile(entry, file) {
   return entry.affectedAnchors.some((anchor) => anchorMatchesFile(anchor, file));
@@ -19862,42 +19928,149 @@ function inferDecisionAnchors(decision, changedFiles) {
   return uniqueStrings8(inferred);
 }
 function normalizeIntentPhrase(value) {
-  return value.replace(INTENT_MARKDOWN_LIST_MARKER_PATTERN, "").replace(INTENT_NUMBERED_LIST_MARKER_PATTERN, "").trim();
+  let normalized = value.trim();
+  if (normalized.startsWith("- ") || normalized.startsWith("* ")) {
+    normalized = normalized.slice(2).trim();
+  }
+  const dotIndex = normalized.indexOf(". ");
+  if (dotIndex > 0) {
+    const prefix = normalized.slice(0, dotIndex);
+    if ([...prefix].every((char) => char >= "0" && char <= "9")) {
+      normalized = normalized.slice(dotIndex + 2).trim();
+    }
+  }
+  return normalized;
 }
-function splitIntentPhrases(value) {
+function splitExplicitIntentList(value) {
   if (!value) return [];
-  return uniqueStrings8(
-    value.split(INTENT_PHRASE_SPLIT_PATTERN).map(normalizeIntentPhrase).filter(Boolean)
-  ).slice(0, 6);
+  return uniqueStrings8(value.split(";").map(normalizeIntentPhrase).filter(Boolean)).slice(0, 6);
 }
-function extractTextMatches(text, patterns, limit) {
-  const matches = patterns.flatMap(
-    (pattern) => [...text.matchAll(pattern)].map((match) => match[0].trim())
+function normalizeIntentList(values) {
+  return uniqueStrings8(values.flatMap((value) => splitExplicitIntentList(value))).slice(0, 8);
+}
+function emptyParsedIntentSections() {
+  return {
+    constraints: [],
+    antiGoals: [],
+    rejectedAlternatives: [],
+    sourceFields: []
+  };
+}
+function intentSectionKey(label) {
+  const normalized = normalizeIdentifier(label);
+  for (const [key, aliases] of Object.entries(INTENT_SECTION_ALIASES)) {
+    if (aliases.includes(normalized)) {
+      return key;
+    }
+  }
+  return void 0;
+}
+function separatorIndex(value) {
+  const colon = value.indexOf(":");
+  const equals = value.indexOf("=");
+  if (colon < 0) return equals;
+  if (equals < 0) return colon;
+  return Math.min(colon, equals);
+}
+function addSectionValue(parsed, key, value) {
+  const normalizedValue = normalizeIntentPhrase(value);
+  if (!normalizedValue) return;
+  parsed.sourceFields.push(key);
+  if (key === "goal") {
+    parsed.goal = parsed.goal ?? normalizedValue;
+    return;
+  }
+  if (key === "owner") {
+    parsed.owner = parsed.owner ?? normalizedValue;
+    return;
+  }
+  if (key === "freshnessHorizonDays") {
+    parsed.freshnessHorizonDays = parsed.freshnessHorizonDays ?? normalizeFreshnessHorizonDays(Number(normalizedValue));
+    return;
+  }
+  parsed[key].push(...splitExplicitIntentList(normalizedValue));
+}
+function parseIntentSections(value) {
+  const parsed = emptyParsedIntentSections();
+  if (!value) return parsed;
+  let currentKey;
+  const lines = value.replaceAll("\r\n", "\n").replaceAll("\r", "\n").split("\n");
+  for (const rawLine of lines) {
+    const line = normalizeIntentPhrase(rawLine);
+    if (!line) continue;
+    const splitAt = separatorIndex(line);
+    if (splitAt > 0) {
+      const maybeKey = intentSectionKey(line.slice(0, splitAt));
+      if (maybeKey) {
+        currentKey = maybeKey;
+        addSectionValue(parsed, maybeKey, line.slice(splitAt + 1));
+        continue;
+      }
+    }
+    if (currentKey && (rawLine.trim().startsWith("- ") || rawLine.trim().startsWith("* "))) {
+      addSectionValue(parsed, currentKey, line);
+    }
+  }
+  return {
+    ...parsed,
+    constraints: uniqueStrings8(parsed.constraints).slice(0, 8),
+    antiGoals: uniqueStrings8(parsed.antiGoals).slice(0, 8),
+    rejectedAlternatives: uniqueStrings8(parsed.rejectedAlternatives).slice(0, 8),
+    sourceFields: uniqueStrings8(parsed.sourceFields)
+  };
+}
+function hasStructuredIntentFields(intent) {
+  return Boolean(
+    intent?.goal || intent?.owner || intent?.freshnessHorizonDays || (intent?.constraints?.length ?? 0) > 0 || (intent?.antiGoals?.length ?? 0) > 0 || (intent?.rejectedAlternatives?.length ?? 0) > 0
   );
-  return uniqueStrings8(matches).slice(0, limit);
 }
-function extractAntiGoals(text) {
-  return extractTextMatches(text, INTENT_TEXT_EXTRACTORS.antiGoals, 5);
+function extractionMetadata(input) {
+  const sectionFields = input.structuredSections.sourceFields.map((field) => `section:${field}`);
+  return {
+    mode: input.structuredFields ? "structured_fields" : sectionFields.length > 0 ? "structured_sections" : "legacy_source_fields",
+    sourceFields: uniqueStrings8([
+      input.structuredFields ? "intent" : void 0,
+      ...sectionFields
+    ]).slice(0, 12),
+    fallbackUsed: input.fallbackUsed
+  };
 }
-function extractRejectedAlternatives(text) {
-  return extractTextMatches(text, INTENT_TEXT_EXTRACTORS.rejectedAlternatives, 5);
+function textHasAnyToken(value, tokens) {
+  const normalized = normalizeIdentifier(value);
+  const parts = normalized.split("_").filter(Boolean);
+  return tokens.some((token) => parts.includes(token));
 }
 function documentLooksLikeIntent(doc) {
-  const text = normalizeText([doc.path, doc.title, doc.contentPreview, doc.kind].join(" "));
-  return /\b(adr|decision|intent|rationale|constraint|architecture|runbook)\b/.test(text);
+  if (hasStructuredIntentFields(doc.intent)) return true;
+  if (parseIntentSections(doc.contentPreview).sourceFields.length > 0) return true;
+  return [doc.path, doc.title, doc.kind].some(
+    (value) => textHasAnyToken(value ?? "", INTENT_DOCUMENT_KIND_TOKENS)
+  );
 }
-function buildDecisionIntentEntry(decision, changedFiles) {
-  const status = intentStatusFromDecision(decision);
+function buildDecisionIntentEntry(decision, changedFiles, policy) {
+  const status = statusFromDecisionStatus(decision);
   const anchors = inferDecisionAnchors(decision, changedFiles);
-  const fullText = decisionText(decision);
+  const sectionIntent = parseIntentSections(
+    [decision.scope, decision.rationale, decision.decision].join("\n")
+  );
+  const structuredFields = hasStructuredIntentFields(decision.intent);
+  const fallbackGoal = decision.rationale || decision.decision || decision.title;
+  const goal = decision.intent?.goal || sectionIntent.goal || fallbackGoal;
   const confidenceScore = normalizeConfidenceScore(
     decision.confidenceScore,
     status === "approved" ? 0.86 : 0.66
   );
+  const freshnessHorizonDays = resolveFreshnessHorizonDays(
+    decision.intent?.freshnessHorizonDays ?? decision.freshnessHorizonDays ?? sectionIntent.freshnessHorizonDays,
+    policy
+  );
   const reasonCodes = uniqueStrings8([
     "decision_intent",
     status === "approved" ? "reviewed_source" : "review_needed",
-    anchors.length > 0 ? "affected_anchors_present" : "affected_anchors_missing"
+    anchors.length > 0 ? "affected_anchors_present" : "affected_anchors_missing",
+    structuredFields ? "structured_intent_fields" : void 0,
+    sectionIntent.sourceFields.length > 0 ? "structured_intent_sections" : void 0,
+    goal === fallbackGoal ? "legacy_goal_fallback" : void 0
   ]);
   return {
     id: `intent:${decision.id}`,
@@ -19907,16 +20080,30 @@ function buildDecisionIntentEntry(decision, changedFiles) {
     sourceDecisionId: decision.id,
     sourceDocumentPath: null,
     intent: {
-      goal: decision.rationale || decision.decision || decision.title,
+      goal,
       constraints: uniqueStrings8([
         ...decision.constraints ?? [],
-        ...splitIntentPhrases(decision.scope)
+        ...decision.intent?.constraints ?? [],
+        ...sectionIntent.constraints
       ]).slice(0, 8),
-      antiGoals: extractAntiGoals(fullText),
-      rejectedAlternatives: extractRejectedAlternatives(fullText)
+      antiGoals: normalizeIntentList([
+        ...decision.antiGoals ?? [],
+        ...decision.intent?.antiGoals ?? [],
+        ...sectionIntent.antiGoals
+      ]),
+      rejectedAlternatives: normalizeIntentList([
+        ...decision.rejectedAlternatives ?? [],
+        ...decision.intent?.rejectedAlternatives ?? [],
+        ...sectionIntent.rejectedAlternatives
+      ])
     },
+    extraction: extractionMetadata({
+      structuredFields,
+      structuredSections: sectionIntent,
+      fallbackUsed: goal === fallbackGoal
+    }),
     affectedAnchors: anchors,
-    owner: null,
+    owner: decision.intent?.owner ?? sectionIntent.owner ?? decision.owner ?? null,
     evidence: decision.evidence && decision.evidence.length > 0 ? decision.evidence : [
       {
         kind: "decision",
@@ -19926,7 +20113,7 @@ function buildDecisionIntentEntry(decision, changedFiles) {
       }
     ],
     confidence: intentConfidence(confidenceScore, status, reasonCodes),
-    staleness: stalenessFromStatus(status),
+    staleness: stalenessFromStatus(status, freshnessHorizonDays),
     reasonCodes,
     recommendedActions: status === "approved" ? ["Keep this intent linked when changing its affected anchors."] : ["Review this intent candidate before treating it as governing project truth."],
     caveats: [
@@ -19934,10 +20121,22 @@ function buildDecisionIntentEntry(decision, changedFiles) {
     ]
   };
 }
-function buildDocumentIntentEntry(doc) {
-  const preview4 = doc.contentPreview || doc.title || doc.path;
-  const reasonCodes = ["document_intent_candidate", "review_needed"];
-  const confidenceScore = doc.kind && /adr|decision/i.test(doc.kind) ? 0.66 : 0.58;
+function buildDocumentIntentEntry(doc, policy) {
+  const sectionIntent = parseIntentSections(doc.contentPreview);
+  const structuredFields = hasStructuredIntentFields(doc.intent);
+  const goal = doc.intent?.goal ?? sectionIntent.goal ?? doc.title ?? doc.path;
+  const reasonCodes = uniqueStrings8([
+    "document_intent_candidate",
+    "review_needed",
+    structuredFields ? "structured_intent_fields" : void 0,
+    sectionIntent.sourceFields.length > 0 ? "structured_intent_sections" : void 0,
+    goal === doc.path || goal === doc.title ? "legacy_goal_fallback" : void 0
+  ]);
+  const confidenceScore = textHasAnyToken(doc.kind ?? "", ["adr", "decision"]) ? 0.66 : 0.58;
+  const freshnessHorizonDays = resolveFreshnessHorizonDays(
+    doc.intent?.freshnessHorizonDays ?? doc.freshnessHorizonDays ?? sectionIntent.freshnessHorizonDays,
+    policy
+  );
   return {
     id: `intent:doc:${doc.path}`,
     title: doc.title || doc.path,
@@ -19946,13 +20145,27 @@ function buildDocumentIntentEntry(doc) {
     sourceDecisionId: null,
     sourceDocumentPath: doc.path,
     intent: {
-      goal: preview4,
-      constraints: splitIntentPhrases(doc.contentPreview).slice(0, 4),
-      antiGoals: extractAntiGoals(preview4),
-      rejectedAlternatives: extractRejectedAlternatives(preview4)
+      goal,
+      constraints: uniqueStrings8([
+        ...doc.intent?.constraints ?? [],
+        ...sectionIntent.constraints
+      ]).slice(0, 4),
+      antiGoals: normalizeIntentList([
+        ...doc.intent?.antiGoals ?? [],
+        ...sectionIntent.antiGoals
+      ]),
+      rejectedAlternatives: normalizeIntentList([
+        ...doc.intent?.rejectedAlternatives ?? [],
+        ...sectionIntent.rejectedAlternatives
+      ])
     },
+    extraction: extractionMetadata({
+      structuredFields,
+      structuredSections: sectionIntent,
+      fallbackUsed: goal === doc.path || goal === doc.title
+    }),
     affectedAnchors: [doc.path],
-    owner: null,
+    owner: doc.intent?.owner ?? sectionIntent.owner ?? doc.owner ?? null,
     evidence: [
       {
         kind: "document",
@@ -19964,7 +20177,8 @@ function buildDocumentIntentEntry(doc) {
     confidence: intentConfidence(confidenceScore, "review_pending", reasonCodes),
     staleness: {
       state: "unknown",
-      reason: "Document-derived intent candidates need review before becoming governing truth."
+      reason: "Document-derived intent candidates need review before becoming governing truth.",
+      horizonDays: freshnessHorizonDays
     },
     reasonCodes,
     recommendedActions: ["Promote, reject, or link this document intent candidate to a decision."],
@@ -19975,15 +20189,19 @@ function buildDocumentIntentEntry(doc) {
 }
 function buildProjectIntentLedger(input, changedFilesOverride) {
   const changedFiles = uniqueStrings8(changedFilesOverride ?? input.changedFiles);
+  const policy = {
+    ...DEFAULT_PROJECT_INTENT_LEDGER_POLICY,
+    ...input.intentPolicy ?? {}
+  };
   const decisionEntries = (input.decisions ?? []).map(
-    (decision) => buildDecisionIntentEntry(decision, changedFiles)
+    (decision) => buildDecisionIntentEntry(decision, changedFiles, policy)
   );
   const decisionDocumentPaths = new Set(
     decisionEntries.flatMap(
       (entry) => entry.evidence.map((evidence) => evidence.sourceRef).filter(Boolean)
     )
   );
-  const documentEntries = (input.documents ?? []).filter(documentLooksLikeIntent).filter((doc) => !decisionDocumentPaths.has(doc.path)).map(buildDocumentIntentEntry);
+  const documentEntries = (input.documents ?? []).filter(documentLooksLikeIntent).filter((doc) => !decisionDocumentPaths.has(doc.path)).map((doc) => buildDocumentIntentEntry(doc, policy));
   const entries = [...decisionEntries, ...documentEntries];
   const linkedIntentIds = new Set(
     entries.filter((entry) => changedFiles.some((file) => intentEntryMatchesFile(entry, file))).map((entry) => entry.id)
@@ -26093,17 +26311,17 @@ function normalizeCollaborationFiles(files) {
 function parseCollaborationResources(values) {
   return normalizeResources(
     (values ?? []).map((value) => {
-      const separatorIndex = value.indexOf(":");
-      if (separatorIndex <= 0) {
+      const separatorIndex2 = value.indexOf(":");
+      if (separatorIndex2 <= 0) {
         throw new Error(`Resource must use KIND:id format: ${value}`);
       }
-      const kind = normalizeResourceKind(value.slice(0, separatorIndex));
+      const kind = normalizeResourceKind(value.slice(0, separatorIndex2));
       if (!kind) {
         throw new Error(
-          `Unsupported collaboration resource kind: ${value.slice(0, separatorIndex)}`
+          `Unsupported collaboration resource kind: ${value.slice(0, separatorIndex2)}`
         );
       }
-      const id = value.slice(separatorIndex + 1).trim();
+      const id = value.slice(separatorIndex2 + 1).trim();
       if (!id) {
         throw new Error(`Resource id is required for ${kind}`);
       }
@@ -27633,12 +27851,12 @@ function parseKeyValueEntries(entries, label) {
   }
   const result = {};
   for (const entry of entries) {
-    const separatorIndex = entry.indexOf("=");
-    if (separatorIndex <= 0 || separatorIndex === entry.length - 1) {
+    const separatorIndex2 = entry.indexOf("=");
+    if (separatorIndex2 <= 0 || separatorIndex2 === entry.length - 1) {
       throw new Error(`Invalid ${label} entry '${entry}'. Expected KEY=value.`);
     }
-    const key = entry.slice(0, separatorIndex).trim();
-    const value = entry.slice(separatorIndex + 1).trim();
+    const key = entry.slice(0, separatorIndex2).trim();
+    const value = entry.slice(separatorIndex2 + 1).trim();
     if (!key || !value) {
       throw new Error(`Invalid ${label} entry '${entry}'. Expected KEY=value.`);
     }

package/docs/FULL_REFERENCE.md

@@ -201,7 +201,12 @@ snipara-companion workflow resume --include-session-context
   dirty local evidence, architecture drift, stale/review-pending intent, and
   heuristic-calibration gaps. Keep `--enforce` opt-in for narrow hooks or
   calibrated CI adapters; the V1 heuristics are advisory and can produce false
-  positives on broad text/path matches.
+  positives on broad text/path matches. Intent Ledger extraction prefers
+  structured contract fields or explicit labeled sections such as `Goal:`,
+  `Constraints:`, `Anti-goals:`, `Rejected alternatives:`, `Owner:`, and
+  `Freshness horizon days:`. Generic prose remains a legacy fallback for goal
+  text only; anti-goals and rejected alternatives are not inferred from loose
+  words in free text.
 - `timeline` is the Git-style log for workflow starts, phase starts, phase
   commits, final commits, and Team Sync handoffs.
 - `workflow impact-gate` audits committed local workflow phases that are ahead
@@ -948,7 +953,7 @@ CI adapter needs the contradiction-to-reality gate without a full hosted brief:
 snipara-companion reality-check \
   --task "refactor auth middleware" \
   --changed-files src/auth/middleware.ts \
-  --decision "DEC-001: auth middleware must keep side effects explicit" \
+  --decision $'DEC-001: Goal: keep auth middleware side effects explicit\nConstraints:\n- auth middleware stays synchronous\nAnti-goals:\n- implicit token refresh' \
   --verification "pnpm test auth" \
   --enforce
 ```
@@ -958,7 +963,9 @@ The command reads the local Git scope by default, includes dirty files unless
 hooks or CI collectors. `--enforce` exits non-zero for `review_required` or
 `blocking` findings, but should stay opt-in until the matched surfaces,
 verification signals, and project-specific thresholds have been calibrated.
-JSON output is available with `--json`.
+Intent can be supplied as structured sections inside `--decision` or
+`--document`, using labels such as `Goal:`, `Constraints:`, `Anti-goals:`,
+`Rejected alternatives:`, and `Owner:`. JSON output is available with `--json`.
 
 Use `intelligence ledger-export` when an agent run, review, or replay benchmark
 needs a portable Coding Intelligence Ledger instead of a raw transcript:

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "snipara-companion",
-  "version": "3.0.9",
+  "version": "3.0.10",
   "description": "Local-first CLI that asks your repo what breaks before an AI coding agent edits it.",
   "main": "dist/index.js",
   "bin": {