@amistio/cli 0.1.21 → 0.1.23

package/README.md

@@ -9,7 +9,7 @@ npm install -g @amistio/cli
 amistio --help
 ```
 
-The package install only installs the `amistio` command. Repository cloning, project pairing, credential storage, sync watching, and runner execution happen only when the user explicitly runs commands such as `amistio bootstrap`, `amistio import`, `amistio pair`, `amistio sync watch`, or `amistio run --watch`. When the app copies a personal project into an organization, the CLI command syntax stays the same; create the org-scoped code and run `amistio import <code>` from the intended local checkout.
+The package install only installs the `amistio` command. Repository cloning, project pairing, credential storage, sync watching, and runner execution happen only when the user explicitly runs commands such as `amistio bootstrap`, `amistio import`, `amistio pair`, `amistio sync watch`, or `amistio run --watch`. When the app copies a personal project into an organization, the CLI command syntax stays the same; create the org-scoped code and run `amistio import <code>` from the intended local checkout. Import scans repo-local project-brain docs plus recognized repo-local IDE, harness, and local AI tool memory or instruction files such as `AGENTS.md`, `.github/copilot-instructions.md`, `.cursor/rules/*.mdc`, `.windsurfrules`, and `memories/*.md`; durable Amistio memory belongs in `docs/memory/`, and global plugin or harness memory outside the repository is not scanned by default.
 
 Runner lifecycle controls in the web app, such as update, restart, and remove, apply only to the runner paired by that user unless the active organization role is an admin role. The runner API binds command polling, command status, logs, activity, and tool sessions to the local runner credential that produced them.
 

package/dist/index.js

@@ -4570,6 +4570,14 @@ var projectContextTopLevelWarningMaxLength = 600;
 var validProjectContextSliceKinds = /* @__PURE__ */ new Set(["overview", "architecture", "domain", "data", "api", "frontend", "backend", "cli", "workflow", "operations", "security", "testing", "unknown"]);
 var validProjectContextEntityTypes = /* @__PURE__ */ new Set(["project", "system", "component", "domain", "tool", "decision", "feature", "risk", "team", "workflow", "unknown"]);
 var validProjectContextRelationTypes = /* @__PURE__ */ new Set(["uses", "depends_on", "decides", "supersedes", "touches", "blocks", "implements", "mentions"]);
+var canonicalProjectContextCitationSources = /* @__PURE__ */ new Map([
+  ["projectbrain", "projectBrain"],
+  ["approvedbrain", "projectBrain"],
+  ["approvedprojectbrain", "projectBrain"],
+  ["localsource", "localSource"],
+  ["runnerstate", "runnerState"],
+  ["mixed", "mixed"]
+]);
 function createImplementationVerificationPrompt(workItem) {
   return [
     "# Amistio Implementation Verification",
@@ -4727,6 +4735,7 @@ function createProjectContextRefreshPrompt(workItem, context) {
     "- Use only these exact singular slice kind values: overview, architecture, domain, data, api, frontend, backend, cli, workflow, operations, security, testing, unknown.",
     "- Capture entities and relations that explain how the app is put together and where future work should look first.",
     "- Prefer summaries, repository-relative paths, short citations, tags, and freshness status over raw source excerpts.",
+    "- Use only these exact citation source values: projectBrain, localSource, runnerState, mixed. Approved project-brain records use projectBrain, not approvedBrain.",
     "- Mark stale or missing areas explicitly instead of guessing.",
     "- Keep coverage.missingAreas entries concise noun phrases under 160 characters.",
     "- Keep coverage.warnings and verificationPlan entries under 300 characters; keep top-level warnings under 600 characters.",
@@ -5400,6 +5409,7 @@ function normalizeProjectContextCitationPaths(value, options) {
         return citation;
       }
       const normalizedCitation = { ...citation };
+      normalizedCitation.source = normalizeProjectContextCitationSource(normalizedCitation.source);
       if (typeof normalizedCitation.repoPath === "string") {
         normalizedCitation.repoPath = normalizeProjectContextRepoPath(normalizedCitation.repoPath, options);
       }
@@ -5408,6 +5418,13 @@ function normalizeProjectContextCitationPaths(value, options) {
   }
   return normalized;
 }
+function normalizeProjectContextCitationSource(value) {
+  if (typeof value !== "string") {
+    return value;
+  }
+  const sourceKey = value.trim().replace(/[\s_-]+/g, "").toLowerCase();
+  return canonicalProjectContextCitationSources.get(sourceKey) ?? value;
+}
 function normalizeProjectContextRepoPath(value, options) {
   const trimmed = value.trim();
   if (!trimmed || /^[A-Za-z][A-Za-z0-9+.-]*:\/\//.test(trimmed) || /^file:/i.test(trimmed) || /^[A-Za-z]:($|[^\\/])/.test(trimmed)) {
@@ -5635,6 +5652,8 @@ var controlPlaneRoots2 = ["architecture", "context", "decisions", "features", "m
 var excludedDirectoryNames = /* @__PURE__ */ new Set([".git", "node_modules", ".pnpm-store", ".next", "dist", "build", "coverage", ".cache", "cache", "tmp", "temp", "vendor"]);
 var excludedFileNames = /* @__PURE__ */ new Set(["docs/context/amistio-project.md", "context/amistio-project.md"]);
 var generatedPathSegments = /* @__PURE__ */ new Set(["generated", "__generated__", "vendor", "vendors"]);
+var rootAgentGuidanceFiles = /* @__PURE__ */ new Set(["agents.md", "claude.md", "gemini.md", "codex.md"]);
+var extensionlessInstructionFiles = /* @__PURE__ */ new Set([".cursorrules", ".windsurfrules", ".clinerules"]);
 var documentFolderByType = {
   architecture: "docs/architecture",
   context: "docs/context",
@@ -5674,7 +5693,7 @@ async function scanLegacyDocuments(options) {
       skipped.push({ repoPath, reason: "excluded" });
       continue;
     }
-    const contentFormat = inferContentFormatFromRepoPath(repoPath);
+    const contentFormat = importableContentFormatFromRepoPath(repoPath);
     if (!contentFormat) {
       skipped.push({ repoPath, reason: "notMarkdown" });
       continue;
@@ -5826,6 +5845,8 @@ function isAmistioManagedDocument(content) {
   return /^\s*<!--[\s\S]*?amistioDocumentId\s*:/i.test(content);
 }
 function classifyLegacyDocument(repoPath, content) {
+  const localMemoryDocumentType = classifyLocalMemoryDocument(repoPath, content);
+  if (localMemoryDocumentType) return localMemoryDocumentType;
   const haystack = `${repoPath} ${inferTitle2(content, repoPath)}`.toLowerCase();
   if (/\b(prompt|prompts|instruction|instructions|copilot|agent|skill)\b/.test(haystack)) return "prompt";
   if (/\b(adr|decision|decisions|rfc)\b/.test(haystack)) return "decision";
@@ -5837,10 +5858,10 @@ function classifyLegacyDocument(repoPath, content) {
   return "context";
 }
 function canonicalImportPath(sourcePath, documentType, contentFormat) {
-  if (isCanonicalControlPlanePath(sourcePath)) {
+  if (isCanonicalControlPlanePath(sourcePath) && inferContentFormatFromRepoPath(sourcePath)) {
     return sourcePath;
   }
-  if (isLegacyControlPlanePath(sourcePath)) {
+  if (isLegacyControlPlanePath(sourcePath) && inferContentFormatFromRepoPath(sourcePath)) {
     return `docs/${sourcePath}`;
   }
   const baseSlug = slugFromPath(sourcePath);
@@ -5859,6 +5880,60 @@ function uniqueDestinationPath(basePath, sourcePath, usedPaths) {
   usedPaths.add(uniquePath);
   return uniquePath;
 }
+function importableContentFormatFromRepoPath(repoPath) {
+  return inferContentFormatFromRepoPath(repoPath) ?? localMemoryImportContentFormat(repoPath);
+}
+function localMemoryImportContentFormat(repoPath) {
+  const normalized = normalizeRepoPath4(repoPath);
+  const lowerPath = normalized.toLowerCase();
+  const basename = lowerPath.split("/").at(-1) ?? lowerPath;
+  if (extensionlessInstructionFiles.has(basename)) return "markdown";
+  if (/\.mdc$/i.test(normalized) && isRepoLocalToolMemoryPath(normalized)) return "markdown";
+  return void 0;
+}
+function classifyLocalMemoryDocument(repoPath, content) {
+  const normalized = normalizeRepoPath4(repoPath);
+  if (!isRepoLocalMemoryOrInstructionPath(normalized)) return void 0;
+  if (isMemoryImportPath(normalized) || hasMemoryCue(normalized, content)) {
+    return "memory";
+  }
+  if (isInstructionImportPath(normalized)) {
+    return "prompt";
+  }
+  return void 0;
+}
+function isRepoLocalMemoryOrInstructionPath(repoPath) {
+  return isMemoryImportPath(repoPath) || isInstructionImportPath(repoPath);
+}
+function isRepoLocalToolMemoryPath(repoPath) {
+  return isRepoLocalMemoryOrInstructionPath(repoPath);
+}
+function isMemoryImportPath(repoPath) {
+  const lowerPath = normalizeRepoPath4(repoPath).toLowerCase();
+  return /^(docs\/memory|memory|memories|\.memory|\.memories)(\/|$)/.test(lowerPath);
+}
+function isInstructionImportPath(repoPath) {
+  const normalized = normalizeRepoPath4(repoPath);
+  const lowerPath = normalized.toLowerCase();
+  const segments = lowerPath.split("/");
+  const basename = segments.at(-1) ?? lowerPath;
+  if (segments.length === 1 && rootAgentGuidanceFiles.has(basename)) return true;
+  if (extensionlessInstructionFiles.has(basename)) return true;
+  if (lowerPath === ".github/copilot-instructions.md") return true;
+  if (lowerPath.startsWith(".github/instructions/") && lowerPath.endsWith(".instructions.md")) return true;
+  if (lowerPath.startsWith(".cursor/rules/") && /\.(md|mdc)$/i.test(lowerPath)) return true;
+  if (lowerPath.startsWith(".windsurf/rules/") && lowerPath.endsWith(".md")) return true;
+  if (lowerPath.startsWith(".cline/") && lowerPath.endsWith(".md")) return true;
+  if (lowerPath.startsWith(".roo/") && lowerPath.endsWith(".md")) return true;
+  if (lowerPath.startsWith(".claude/") && lowerPath.endsWith(".md")) return true;
+  if (lowerPath.startsWith(".gemini/") && lowerPath.endsWith(".md")) return true;
+  if (lowerPath.startsWith(".vscode/") && lowerPath.endsWith(".instructions.md")) return true;
+  return false;
+}
+function hasMemoryCue(repoPath, content) {
+  const haystack = `${repoPath} ${inferTitle2(content, repoPath)}`.toLowerCase();
+  return /\b(memory|memories|lesson|lessons|mistake|mistakes|learning|retro|retrospective|observation|observations)\b/.test(haystack);
+}
 function isCanonicalControlPlanePath(repoPath) {
   const [firstSegment, secondSegment, thirdSegment] = normalizeRepoPath4(repoPath).split("/");
   return firstSegment === "docs" && Boolean(secondSegment === "html" && thirdSegment && controlPlaneRoots2.includes(thirdSegment) || secondSegment && controlPlaneRoots2.includes(secondSegment));
@@ -5884,7 +5959,7 @@ function stripFrontmatter(content) {
   return closingLineEnd === -1 ? "" : content.slice(closingLineEnd + 1);
 }
 function slugFromPath(repoPath) {
-  const withoutExtension = repoPath.replace(/\.(md|mdx|html?)$/i, "");
+  const withoutExtension = repoPath.replace(/\.(md|mdx|mdc|html?)$/i, "");
   const slug = withoutExtension.toLowerCase().replace(/[^a-z0-9]+/g, "-").replace(/^-+|-+$/g, "").slice(0, 90);
   return slug || "imported-document";
 }