@maycombhq/atticus 2.0.0-beta.2 → 2.0.0-beta.21

package/dist/{chunk-UNM6ZOKP.js → chunk-NTAVOWYD.js}

@@ -10,18 +10,30 @@ import {
   CHANGE_DRAFTER,
   CHECK_DRAFT_TOOL,
   COMMENT_COMMAND,
+  CORRECTIONS_FILE,
+  CORRECTIONS_RULE,
   COVERS_ANSWER_SPEC,
   COVERS_OPTIONS,
+  Correction,
+  CorrectionScope,
+  CorrectionState,
+  CorrectionsFile,
   DEFAULT_DONE,
   DEFAULT_DOR_CHECKS,
   DEPLOY_FILE,
   DESIGN_FORMAT,
   DIGEST_KINDS,
   DOR_CHECKS,
+  DRAFTED_FILE,
   DRAFTING_CHECKS,
   DRAFTING_STAGE_RULES,
+  DRAFTS_SCHEMA_VERSION,
+  DRAFT_ITEMS_MAX,
   DRAFT_MARK,
   DRAFT_OUTPUT,
+  DRAWN,
+  DraftedFile,
+  DraftedRecord,
   ENGINE_DEFAULT,
   ERROR_RULE_WORDS,
   ESTATE_HEADING,
@@ -32,6 +44,7 @@ import {
   FEATURE_KNOWLEDGE,
   GAP_RULE,
   GENERATED_MARK,
+  GUESSED_LINK_RULE,
   HAND_BACKS,
   KEEP_BY_MEANING,
   KEEP_ONE_WORD_CLOSE,
@@ -39,6 +52,7 @@ import {
   KNOWLEDGE_INDEX_KINDS,
   KnowledgeApplies,
   KnowledgeStatus,
+  MAX_CHAIN_DEPTH,
   NEEDS_ERROR_CASE,
   NEEDS_FILE,
   NEEDS_FINDER,
@@ -52,6 +66,7 @@ import {
   PERSON_DRAFT,
   PROPOSALS_DIR,
   PROPOSAL_MARK,
+  PROTOTYPE_NEW_RULE,
   PlannerError,
   READS_FILE,
   READ_AGAIN_RULE,
@@ -65,7 +80,9 @@ import {
   SECTION_KINDS,
   SECTION_SHARE,
   SECTION_TOKENS,
+  SEED_MARK,
   SELF_CHECK_RULE,
+  SKETCH_RULE,
   SMALL_AGENT,
   SMALL_ANSWER_FILE,
   SPEC_MARK,
@@ -81,12 +98,14 @@ import {
   STORY_WRITER,
   SYNC_FILE,
   SmallAnswer,
+  SnowFillError,
   StoriesAnswerSchema,
   StoryCriterion,
   StoryDataChange,
   StoryEval,
   StoryInterfaceChange,
   StoryInterfaceField,
+  Stroke,
   SyncFile,
   TARGET_DIR,
   TASK_KNOWLEDGE_KINDS,
@@ -99,8 +118,11 @@ import {
   TargetFlowsAnswer,
   YAML_QUOTE_RULE,
   acceptingCriteria,
+  addCorrection,
+  addedFlowsOf,
   allowedValuesOf,
   allowedValuesSource,
+  applyStroke,
   architectureStage,
   asSources,
   askGaps,
@@ -110,11 +132,13 @@ import {
   briefEndpointNotes,
   briefEndpoints,
   briefEndpointsSource,
+  buildLine,
   buildSkeleton,
   callsAt,
   candidatesOf,
   capabilityOf,
   changeDrafter,
+  changeImpact,
   checkDeltas,
   checkDesign,
   checkDraft,
@@ -140,6 +164,7 @@ import {
   consumersSource,
   contentWords,
   contextToolsFor,
+  correctionsText,
   coverage,
   coverageIssues,
   coversInputs,
@@ -164,8 +189,14 @@ import {
   draftChange,
   draftCheckBox,
   draftFor,
+  draftItemText,
+  draftItems,
+  draftProvenance,
+  draftSha,
   draftTemplates,
   draftedStories,
+  drawnBy,
+  drawnStrokes,
   emptyDeltaIssues,
   endpointConsumers,
   endpointKey,
@@ -184,6 +215,7 @@ import {
   featureStage,
   fieldLikeNames,
   filePending,
+  fillSnowFields,
   findKnowledgeItem,
   findNeeds,
   findTask,
@@ -208,6 +240,8 @@ import {
   inScope,
   instructionSource,
   interfaceChanges,
+  isDrawnDelta,
+  isDrawnStep,
   isEmptyDelta,
   isHowTo,
   isKeyPattern,
@@ -219,6 +253,7 @@ import {
   knownFieldNames,
   knownSources,
   lastValidRel,
+  lineAtFolded,
   lineExists,
   loadEstate,
   loadPlanContext,
@@ -236,6 +271,7 @@ import {
   namesOf,
   nearDuplicates,
   needQuoteProblem,
+  newStrokeId,
   newestFindings,
   nextMigration,
   noteCiteIssues,
@@ -243,6 +279,7 @@ import {
   noteConflictLines,
   noteQuestions,
   oneSource,
+  openSeeds,
   openspecFiles,
   openspecInstructionSource,
   openspecProgress,
@@ -263,14 +300,18 @@ import {
   placeText,
   placeWords,
   plainWhy,
+  planSketchWrite,
   planStories,
   planText,
   promptFileOf,
+  prototypeNewCallsSource,
   questionsOnFile,
   rankPages,
   readCheckoutFile,
   readConformDeltas,
+  readCorrections,
   readDeltas,
+  readDrafted,
   readDrafts,
   readExistingSpecs,
   readFigma,
@@ -284,12 +325,15 @@ import {
   readSyncFile,
   readTargetFlows,
   readTaskSteps,
+  recordAiDraft,
   recordKnowledge,
+  recordPersonSave,
   recordTaskKnowledge,
   refreshTaskConflicts,
   refuseWhileEarlierStuck,
   relevantMap,
   reliedOn,
+  removeCorrection,
   renderArchitecture,
   renderBreaking,
   renderData,
@@ -299,6 +343,8 @@ import {
   renderNeeds,
   renderProposal,
   renderRollback,
+  renderSeedProposal,
+  renderSketchDelta,
   renderSnow,
   renderSpecDelta,
   renderStory,
@@ -309,6 +355,8 @@ import {
   reportOf,
   requestFieldsOf,
   rerankFor,
+  retireChangeEscalations,
+  retireSettledEscalations,
   retrievalWaiting,
   retrieve,
   retypedColumns,
@@ -318,14 +366,24 @@ import {
   scenarioOf,
   schemaFieldsOf,
   scopeRepos,
+  seedChangeId,
+  seedCollisionWords,
+  seedCollisions,
+  seedRequirement,
+  seedSpec,
   selectFor,
   selectStoriesKnowledge,
   selectTaskKnowledge,
   sentenceCase,
   setKnowledgeStatus,
+  settleCorrections,
   settleCoversAnswers,
+  sketchFingerprint,
+  sketchOf,
+  sketchSlug,
   slug,
   smallStage,
+  snapshotFiles,
   snowDraft,
   snowNeeds,
   sourceTokens,
@@ -335,6 +393,7 @@ import {
   sqlNameOf,
   stageBudget,
   stageComments,
+  stageCorrections,
   stageEnd,
   stageGate,
   stageOfOutput,
@@ -365,6 +424,7 @@ import {
   storyPack,
   storySteps,
   storyWriter,
+  strokeIdOf,
   submitRequests,
   syncWorkItems,
   systemOf,
@@ -380,6 +440,7 @@ import {
   templateWriter,
   templateYaml,
   tickedTasks,
+  titledText,
   touchedTables,
   triggerEntry,
   unfence,
@@ -389,6 +450,7 @@ import {
   validateDraft,
   whenFromLeadTime,
   wholeLists,
+  withBuildLine,
   withTools,
   withoutResume,
   wordsOnlyNote,
@@ -397,13 +459,14 @@ import {
   writePlacement,
   writeProposal,
   writeProse,
+  writeSketch,
   writeSpecFiles,
   writeStageLoop,
   writeStories,
   writeTargetFlows,
   writesField,
   yamlOf
-} from "./chunk-CKSITVS4.js";
+} from "./chunk-BEPCKDCP.js";
 import {
   Backing,
   DeltaFields,
@@ -429,25 +492,25 @@ import {
   rerunOf,
   usesOf,
   waitingQuestions
-} from "./chunk-L6SGQIR3.js";
+} from "./chunk-HWD4JPU7.js";
+import "./chunk-5WERBKLE.js";
 import {
   MERGED_FLOWS
-} from "./chunk-3HI6Z55Y.js";
-import "./chunk-XY3P7JW7.js";
-import "./chunk-4AK7IBVP.js";
-import "./chunk-7JUKDRSZ.js";
-import "./chunk-27NKUS3X.js";
-import "./chunk-L24C55VN.js";
-import "./chunk-PAMPPUR6.js";
-import "./chunk-23W7VWKR.js";
-import "./chunk-7EKXJZ2Y.js";
-import "./chunk-MC3H7736.js";
-import "./chunk-T6AIP7H5.js";
-import "./chunk-EFHQ3TWP.js";
-import "./chunk-GQ4N4WKF.js";
-import "./chunk-CNUKCS2T.js";
-import "./chunk-S2A7YC3Q.js";
-import "./chunk-D3PO4DOZ.js";
+} from "./chunk-K332XW7K.js";
+import "./chunk-HSZMPH5T.js";
+import "./chunk-D2WSW4GU.js";
+import "./chunk-4KNOJC6J.js";
+import "./chunk-4SLBCEPD.js";
+import "./chunk-64AADMTW.js";
+import "./chunk-JYMIB5XY.js";
+import "./chunk-CPK7QSBG.js";
+import "./chunk-YO2PKTXT.js";
+import "./chunk-TWQRPM76.js";
+import "./chunk-XOL3GFW2.js";
+import "./chunk-QHJJMZLX.js";
+import "./chunk-7AB6OWTV.js";
+import "./chunk-PAINMSID.js";
+import "./chunk-ODMBPDDV.js";
 import "./chunk-TV45EUGM.js";
 var export_yamlText = import_yaml.stringify;
 export {
@@ -458,24 +521,36 @@ export {
   CHANGE_DRAFTER,
   CHECK_DRAFT_TOOL,
   COMMENT_COMMAND,
+  CORRECTIONS_FILE,
+  CORRECTIONS_RULE,
   COVERS_ANSWER_SPEC,
   COVERS_OPTIONS,
+  Correction,
+  CorrectionScope,
+  CorrectionState,
+  CorrectionsFile,
   DEFAULT_DONE,
   DEFAULT_DOR_CHECKS,
   DEPLOY_FILE,
   DESIGN_FORMAT,
   DIGEST_KINDS,
   DOR_CHECKS,
+  DRAFTED_FILE,
   DRAFTING_CHECKS,
   DRAFTING_STAGE_RULES,
+  DRAFTS_SCHEMA_VERSION,
+  DRAFT_ITEMS_MAX,
   DRAFT_MARK,
   DRAFT_OUTPUT,
+  DRAWN,
   DeltaFields,
   DeltaStep,
   DeployStep,
   DesignAction,
   DesignField,
   DesignScreen,
+  DraftedFile,
+  DraftedRecord,
   ENGINE_DEFAULT,
   ERROR_RULE_WORDS,
   ESTATE_HEADING,
@@ -489,6 +564,7 @@ export {
   FlowDelta,
   GAP_RULE,
   GENERATED_MARK,
+  GUESSED_LINK_RULE,
   HAND_BACKS,
   KEEP_BY_MEANING,
   KEEP_ONE_WORD_CLOSE,
@@ -497,6 +573,7 @@ export {
   KnowledgeApplies,
   KnowledgeStatus,
   LoopFinding,
+  MAX_CHAIN_DEPTH,
   MERGED_FLOWS,
   NEEDS_ERROR_CASE,
   NEEDS_FILE,
@@ -512,6 +589,7 @@ export {
   PERSON_DRAFT,
   PROPOSALS_DIR,
   PROPOSAL_MARK,
+  PROTOTYPE_NEW_RULE,
   PlannerError,
   READS_FILE,
   READ_AGAIN_RULE,
@@ -525,7 +603,9 @@ export {
   SECTION_KINDS,
   SECTION_SHARE,
   SECTION_TOKENS,
+  SEED_MARK,
   SELF_CHECK_RULE,
+  SKETCH_RULE,
   SMALL_AGENT,
   SMALL_ANSWER_FILE,
   SPEC_MARK,
@@ -543,7 +623,9 @@ export {
   STORY_PROSE_OUTPUT,
   STORY_WRITER,
   SYNC_FILE,
+  FlowDelta as SketchDelta,
   SmallAnswer,
+  SnowFillError,
   Stage,
   StageLoop,
   StoreKey,
@@ -553,6 +635,7 @@ export {
   StoryEval,
   StoryInterfaceChange,
   StoryInterfaceField,
+  Stroke,
   SyncFile,
   TARGET_DIR,
   TASK_KNOWLEDGE_KINDS,
@@ -565,8 +648,11 @@ export {
   TargetFlowsAnswer,
   YAML_QUOTE_RULE,
   acceptingCriteria,
+  addCorrection,
+  addedFlowsOf,
   allowedValuesOf,
   allowedValuesSource,
+  applyStroke,
   architectureStage,
   asSources,
   askGaps,
@@ -576,11 +662,13 @@ export {
   briefEndpointNotes,
   briefEndpoints,
   briefEndpointsSource,
+  buildLine,
   buildSkeleton,
   callsAt,
   candidatesOf,
   capabilityOf,
   changeDrafter,
+  changeImpact,
   checkDeltas,
   checkDesign,
   checkDraft,
@@ -606,6 +694,7 @@ export {
   consumersSource,
   contentWords,
   contextToolsFor,
+  correctionsText,
   coverage,
   coverageIssues,
   coversInputs,
@@ -630,8 +719,14 @@ export {
   draftChange,
   draftCheckBox,
   draftFor,
+  draftItemText,
+  draftItems,
+  draftProvenance,
+  draftSha,
   draftTemplates,
   draftedStories,
+  drawnBy,
+  drawnStrokes,
   emptyDeltaIssues,
   endpointConsumers,
   endpointKey,
@@ -651,6 +746,7 @@ export {
   fieldLikeNames,
   fieldNames,
   filePending,
+  fillSnowFields,
   findKnowledgeItem,
   findNeeds,
   findTask,
@@ -674,6 +770,8 @@ export {
   inScope,
   instructionSource,
   interfaceChanges,
+  isDrawnDelta,
+  isDrawnStep,
   isEmptyDelta,
   isHowTo,
   isKeyPattern,
@@ -685,6 +783,7 @@ export {
   knownFieldNames,
   knownSources,
   lastValidRel,
+  lineAtFolded,
   lineExists,
   loadEstate,
   loadPlanContext,
@@ -702,6 +801,7 @@ export {
   namesOf,
   nearDuplicates,
   needQuoteProblem,
+  newStrokeId,
   newestFindings,
   nextMigration,
   noteCiteIssues,
@@ -709,6 +809,7 @@ export {
   noteConflictLines,
   noteQuestions,
   oneSource,
+  openSeeds,
   openspecFiles,
   openspecInstructionSource,
   openspecProgress,
@@ -731,14 +832,18 @@ export {
   placeText,
   placeWords,
   plainWhy,
+  planSketchWrite,
   planStories,
   planText,
   promptFileOf,
+  prototypeNewCallsSource,
   questionsOnFile,
   rankPages,
   readCheckoutFile,
   readConformDeltas,
+  readCorrections,
   readDeltas,
+  readDrafted,
   readDrafts,
   readExistingSpecs,
   readFigma,
@@ -752,12 +857,15 @@ export {
   readSyncFile,
   readTargetFlows,
   readTaskSteps,
+  recordAiDraft,
   recordKnowledge,
+  recordPersonSave,
   recordTaskKnowledge,
   refreshTaskConflicts,
   refuseWhileEarlierStuck,
   relevantMap,
   reliedOn,
+  removeCorrection,
   renderArchitecture,
   renderBreaking,
   renderData,
@@ -767,6 +875,8 @@ export {
   renderNeeds,
   renderProposal,
   renderRollback,
+  renderSeedProposal,
+  renderSketchDelta,
   renderSnow,
   renderSpecDelta,
   renderStory,
@@ -778,6 +888,8 @@ export {
   requestFieldsOf,
   rerankFor,
   rerunOf,
+  retireChangeEscalations,
+  retireSettledEscalations,
   retrievalWaiting,
   retrieve,
   retypedColumns,
@@ -787,14 +899,24 @@ export {
   scenarioOf,
   schemaFieldsOf,
   scopeRepos,
+  seedChangeId,
+  seedCollisionWords,
+  seedCollisions,
+  seedRequirement,
+  seedSpec,
   selectFor,
   selectStoriesKnowledge,
   selectTaskKnowledge,
   sentenceCase,
   setKnowledgeStatus,
+  settleCorrections,
   settleCoversAnswers,
+  sketchFingerprint,
+  sketchOf,
+  sketchSlug,
   slug,
   smallStage,
+  snapshotFiles,
   snowDraft,
   snowNeeds,
   sourceTokens,
@@ -804,6 +926,7 @@ export {
   sqlNameOf,
   stageBudget,
   stageComments,
+  stageCorrections,
   stageEnd,
   stageGate,
   stageOfOutput,
@@ -834,6 +957,7 @@ export {
   storyPack,
   storySteps,
   storyWriter,
+  strokeIdOf,
   submitRequests,
   syncWorkItems,
   systemOf,
@@ -849,6 +973,7 @@ export {
   templateWriter,
   templateYaml,
   tickedTasks,
+  titledText,
   touchedTables,
   triggerEntry,
   unfence,
@@ -860,6 +985,7 @@ export {
   waitingQuestions,
   whenFromLeadTime,
   wholeLists,
+  withBuildLine,
   withTools,
   withoutResume,
   wordsOnlyNote,
@@ -868,6 +994,7 @@ export {
   writePlacement,
   writeProposal,
   writeProse,
+  writeSketch,
   writeSpecFiles,
   writeStageLoop,
   writeStories,

package/dist/{chunk-3USYZGRF.js → chunk-NYOABJNK.js}

@@ -9,12 +9,12 @@ import {
 } from "./chunk-R6RY4Q5T.js";
 import {
   runDesignBench
-} from "./chunk-CPA6HPVR.js";
-import "./chunk-BOHJZTEQ.js";
-import "./chunk-MVZVGYXH.js";
-import "./chunk-KEM4SDDP.js";
-import "./chunk-2ANOROX3.js";
-import "./chunk-65NYPGRC.js";
+} from "./chunk-FYBF5MB2.js";
+import "./chunk-36RY7ZXM.js";
+import "./chunk-2V2ZPQQU.js";
+import "./chunk-P2VBXX7N.js";
+import "./chunk-EZIN5E5B.js";
+import "./chunk-3LZ6P5EP.js";
 import {
   TARGET_DIR,
   architectureStage,
@@ -25,36 +25,37 @@ import {
   stageEnd,
   stageGate,
   storiesStage
-} from "./chunk-CKSITVS4.js";
-import "./chunk-L6SGQIR3.js";
+} from "./chunk-BEPCKDCP.js";
+import "./chunk-HWD4JPU7.js";
+import "./chunk-5WERBKLE.js";
 import {
   gateStatus,
   ownerWaitsLine
-} from "./chunk-3HI6Z55Y.js";
+} from "./chunk-K332XW7K.js";
 import {
   changeFolder,
   loadChangeContext
-} from "./chunk-XY3P7JW7.js";
-import "./chunk-4AK7IBVP.js";
-import "./chunk-7JUKDRSZ.js";
-import "./chunk-27NKUS3X.js";
-import "./chunk-L24C55VN.js";
-import "./chunk-PAMPPUR6.js";
-import "./chunk-23W7VWKR.js";
-import "./chunk-7EKXJZ2Y.js";
-import "./chunk-MC3H7736.js";
-import "./chunk-T6AIP7H5.js";
-import "./chunk-EFHQ3TWP.js";
-import "./chunk-GQ4N4WKF.js";
+} from "./chunk-HSZMPH5T.js";
+import "./chunk-D2WSW4GU.js";
+import "./chunk-4KNOJC6J.js";
+import "./chunk-4SLBCEPD.js";
+import "./chunk-64AADMTW.js";
+import "./chunk-JYMIB5XY.js";
+import "./chunk-CPK7QSBG.js";
+import "./chunk-YO2PKTXT.js";
+import "./chunk-TWQRPM76.js";
+import "./chunk-XOL3GFW2.js";
 import {
   RuntimeConfigError,
   runtimeForCli
-} from "./chunk-CNUKCS2T.js";
+} from "./chunk-QHJJMZLX.js";
+import "./chunk-7AB6OWTV.js";
 import {
+  RecordId,
   changesRelOf,
   orgPackDirOf
-} from "./chunk-S2A7YC3Q.js";
-import "./chunk-D3PO4DOZ.js";
+} from "./chunk-PAINMSID.js";
+import "./chunk-ODMBPDDV.js";
 import "./chunk-TV45EUGM.js";
 
 // packages/cli/dist/stage-commands.js
@@ -144,8 +145,15 @@ function printStage(r, rerun, io, extra = [], owner) {
         io.out(`  ${f.message}`);
     }
     const w = r.waiting;
-    io.report?.({ handoff: { runId: w.runId, ...w.lens ? { lens: w.lens } : {} } });
-    io.out(w.lens ? `Handed the critic's ${w.lens} lens to your assistant to review the ${NAMES[r.stage]} draft (run ${w.runId}). When it is done, run: atticus handoff done ${w.runId}, then ${rerun} --resume ${w.runId}` : `Handed the ${NAMES[r.stage]} draft to your assistant (run ${w.runId}). When it is done, run: atticus handoff done ${w.runId}, then ${rerun} --resume ${w.runId}`);
+    io.report?.({
+      handoff: {
+        runId: w.runId,
+        ...w.lens ? { lens: w.lens } : {},
+        ...w.lenses ? { lenses: w.lenses } : {}
+      }
+    });
+    const together = w.lenses ? w.lenses.length === 1 ? `the critic's ${w.lenses[0]} lens` : `the critic's ${w.lenses.slice(0, -1).join(", ")} and ${w.lenses.at(-1)} lenses, in one prompt,` : void 0;
+    io.out(together ? `Handed ${together} to your assistant to review the ${NAMES[r.stage]} draft (run ${w.runId}). When it is done, run: atticus handoff done ${w.runId}, then ${rerun} --resume ${w.runId}` : w.lens ? `Handed the critic's ${w.lens} lens to your assistant to review the ${NAMES[r.stage]} draft (run ${w.runId}). When it is done, run: atticus handoff done ${w.runId}, then ${rerun} --resume ${w.runId}` : `Handed the ${NAMES[r.stage]} draft to your assistant (run ${w.runId}). When it is done, run: atticus handoff done ${w.runId}, then ${rerun} --resume ${w.runId}`);
     return 1;
   }
   if (r.state === "questions") {
@@ -169,7 +177,8 @@ function printStage(r, rerun, io, extra = [], owner) {
 async function stageCli(root, positionals, values, io, deps = {}) {
   const [group, command, arg] = positionals;
   const json = values.json === true;
-  const isStage = group === "change" && (command === "feature" || command === "architecture" || command === "small") || group === "plan" && command === "stories" && !!arg && existsSync(join(changeFolder(root, arg), TARGET_DIR));
+  const isStage = group === "change" && (command === "feature" || command === "architecture" || command === "small") || group === "plan" && command === "stories" && !!arg && // A mistyped argument isn't a change: it falls through to planStories and its usage words.
+  RecordId.safeParse(arg).success && existsSync(join(changeFolder(root, arg), TARGET_DIR));
   if (group === "bench" && command === "design")
     return benchDesign(root, values, io, deps);
   if (!isStage)