@snapback/cli 1.6.0 → 3.0.1

package/dist/chunk-CBGOC6RV.js

@@ -0,0 +1,293 @@
+#!/usr/bin/env node --no-warnings=ExperimentalWarning
+import { __name } from './chunk-7ADPL4Q3.js';
+import { z } from 'zod';
+
+process.env.SNAPBACK_CLI='true';
+var LearningTypeSchema = z.enum([
+  "pattern",
+  "pitfall",
+  "efficiency",
+  "workflow",
+  "discovery"
+]);
+var LearningIntentSchema = z.enum([
+  "implement",
+  "debug",
+  "refactor",
+  "review"
+]);
+z.enum([
+  "add-flag",
+  "set-env",
+  "inject-validation",
+  "warn",
+  "suggest-file"
+]);
+var WarnSeveritySchema = z.enum([
+  "info",
+  "warning",
+  "error"
+]);
+var AddFlagPayloadSchema = z.object({
+  flag: z.string().min(1).describe("CLI flag to add, e.g. '--validate-expiry'"),
+  value: z.union([
+    z.string(),
+    z.boolean()
+  ]).optional().describe("Flag value if applicable"),
+  reason: z.string().min(1).describe("Human-readable reason shown in verbose mode")
+});
+var SetEnvPayloadSchema = z.object({
+  key: z.string().min(1).regex(/^[A-Z_][A-Z0-9_]*$/, "Must be valid env var name"),
+  value: z.string().describe("Environment variable value"),
+  reason: z.string().min(1).describe("Human-readable reason shown in verbose mode")
+});
+var InjectValidationPayloadSchema = z.object({
+  validationType: z.string().min(1).describe("Validation type identifier, e.g. 'jwt-expiry', 'silent-catch'"),
+  targetFile: z.string().optional().describe("Optional file to target for validation"),
+  reason: z.string().min(1).describe("Human-readable reason shown in verbose mode")
+});
+var WarnPayloadSchema = z.object({
+  message: z.string().min(1).describe("Warning message to display"),
+  severity: WarnSeveritySchema.describe("Severity level affects display styling")
+});
+var SuggestFilePayloadSchema = z.object({
+  filePath: z.string().min(1).describe("Suggested file path, may contain {feature} placeholder"),
+  reason: z.string().min(1).describe("Human-readable reason for suggestion")
+});
+var LearningTriggerSchema = z.object({
+  commands: z.array(z.string()).optional().describe("Command names that trigger this learning, e.g. ['auth', 'deploy']"),
+  intent: z.array(LearningIntentSchema).optional().describe("Intent types that trigger this learning"),
+  filePatterns: z.array(z.string()).optional().describe("Glob patterns for file matching, e.g. ['**/*auth*.ts']"),
+  flags: z.array(z.string()).optional().describe("CLI flags that trigger this learning, e.g. ['--provider']"),
+  description: z.string().min(1).describe("Human-readable description for fuzzy matching")
+});
+var LearningActionSchema = z.discriminatedUnion("type", [
+  z.object({
+    type: z.literal("add-flag"),
+    payload: AddFlagPayloadSchema
+  }),
+  z.object({
+    type: z.literal("set-env"),
+    payload: SetEnvPayloadSchema
+  }),
+  z.object({
+    type: z.literal("inject-validation"),
+    payload: InjectValidationPayloadSchema
+  }),
+  z.object({
+    type: z.literal("warn"),
+    payload: WarnPayloadSchema
+  }),
+  z.object({
+    type: z.literal("suggest-file"),
+    payload: SuggestFilePayloadSchema
+  })
+]);
+var LearningSchema = z.object({
+  id: z.string().min(1).describe("Unique identifier for this learning"),
+  type: LearningTypeSchema.describe("Categorical classification"),
+  trigger: LearningTriggerSchema.describe("Conditions that activate this learning"),
+  action: LearningActionSchema.describe("Concrete action to execute"),
+  confidence: z.number().min(0).max(1).describe("Confidence score (0.0-1.0), static at creation"),
+  created: z.number().int().positive().describe("Creation timestamp (ms since epoch)"),
+  lastUsed: z.number().int().positive().optional().describe("Last usage timestamp (ms since epoch)"),
+  usageCount: z.number().int().nonnegative().default(0).describe("Number of times this learning was applied"),
+  tags: z.array(z.string()).default([]).describe("Searchable tags for categorization"),
+  archived: z.boolean().default(false).describe("Whether this learning is archived (excluded from matching)")
+});
+LearningSchema.omit({
+  id: true,
+  created: true,
+  lastUsed: true,
+  usageCount: true,
+  archived: true
+}).extend({
+  tags: z.array(z.string()).optional().default([]),
+  archived: z.boolean().optional()
+});
+z.enum([
+  "observe",
+  "warn",
+  "apply-safe",
+  "apply-all",
+  "off"
+]);
+z.object({
+  workspaceId: z.string().min(1),
+  startedAt: z.number().int().positive(),
+  lastCommandAt: z.number().int().positive(),
+  appliedLearnings: z.array(z.string()).describe("Learning IDs applied in this session")
+});
+z.object({
+  workspaceId: z.string().min(1),
+  commandName: z.string().min(1),
+  args: z.record(z.unknown()).optional().describe("Parsed command arguments/flags"),
+  filesOrPaths: z.array(z.string()).optional().describe("Files involved in command"),
+  intent: LearningIntentSchema.optional().describe("User intent if known")
+});
+var SelectedLearningSchema = z.object({
+  id: z.string(),
+  title: z.string().describe("Human-readable title derived from trigger.description"),
+  type: LearningTypeSchema,
+  score: z.number().min(0).max(1),
+  action: LearningActionSchema,
+  tags: z.array(z.string())
+});
+z.object({
+  selectedLearnings: z.array(SelectedLearningSchema),
+  debug: z.object({
+    evaluatedCount: z.number().int().nonnegative(),
+    durationMs: z.number().nonnegative(),
+    skippedReason: z.string().optional()
+  }).optional()
+});
+var LearningTierSchema = z.enum([
+  "hot",
+  "warm",
+  "cold"
+]);
+var LearningPrioritySchema = z.enum([
+  "critical",
+  "high",
+  "medium",
+  "low"
+]);
+var LearningStorageTypeSchema = z.enum([
+  "pattern",
+  "pitfall",
+  "pit",
+  "architecture",
+  "performance",
+  "efficiency",
+  "discovery",
+  "workflow",
+  "best-practice"
+]);
+var LearningStorageSchema = z.object({
+  id: z.string().min(1).optional(),
+  type: LearningStorageTypeSchema,
+  trigger: z.union([
+    z.string(),
+    z.array(z.string())
+  ]),
+  context: z.string().optional(),
+  problem: z.string().optional(),
+  solution: z.string().optional(),
+  action: z.string(),
+  related: z.array(z.string()).optional(),
+  source: z.string(),
+  timestamp: z.union([
+    z.string(),
+    z.number()
+  ]).describe("ISO 8601 string or epoch number from storage"),
+  // Tiering metadata (optional)
+  tier: LearningTierSchema.optional(),
+  domain: z.string().optional(),
+  priority: LearningPrioritySchema.optional(),
+  keywords: z.array(z.string()).optional(),
+  // Usage tracking (optional)
+  accessCount: z.number().int().nonnegative().optional(),
+  lastAccessed: z.string().optional(),
+  relevanceScore: z.number().min(0).max(1).optional(),
+  appliedDate: z.string().optional()
+});
+var ChunkSourceTypeSchema = z.enum([
+  "learning",
+  "adr",
+  "pattern",
+  "violation"
+]);
+var ChunkStatusSchema = z.enum([
+  "active",
+  "deprecated",
+  "superseded"
+]);
+z.object({
+  id: z.string().describe("Unique chunk identifier"),
+  source_type: ChunkSourceTypeSchema.describe("Type of source this chunk came from"),
+  source_id: z.string().describe("ID of the source record"),
+  chunk_text: z.string().describe("The actual content text"),
+  context_text: z.string().optional().describe("Optional context surrounding the chunk"),
+  authority: z.number().min(0).max(1).describe("Authority score (0-1)"),
+  status: ChunkStatusSchema.describe("Current status of the chunk"),
+  created_at: z.string().describe("ISO 8601 creation timestamp"),
+  updated_at: z.string().describe("ISO 8601 update timestamp"),
+  metadata: z.record(z.unknown()).optional().describe("Optional JSON metadata")
+});
+var OutcomeTypeSchema = z.enum([
+  "accepted",
+  "ignored",
+  "test_pass",
+  "test_fail",
+  "violation_prevented"
+]);
+z.object({
+  id: z.string(),
+  chunk_id: z.string(),
+  outcome_type: OutcomeTypeSchema,
+  context: z.record(z.unknown()).optional(),
+  created_at: z.string()
+});
+var LearningApiSchema = z.object({
+  id: z.string().min(1).describe("Unique identifier"),
+  type: LearningTypeSchema.describe("Categorical classification"),
+  trigger: z.string().describe("Normalized trigger condition"),
+  action: z.string().describe("Action to take (human-readable)"),
+  confidence: z.number().min(0).max(1).describe("Confidence score (0.0-1.0)"),
+  created: z.number().int().positive().describe("Creation timestamp (ms since epoch)"),
+  source: z.string().describe("Where this learning originated"),
+  tags: z.array(z.string()).default([]).describe("Searchable tags"),
+  usageCount: z.number().int().nonnegative().default(0).describe("Times applied")
+});
+function normalizeLearningType(type) {
+  switch (type) {
+    case "pattern":
+      return "pattern";
+    case "pitfall":
+    case "pit":
+      return "pitfall";
+    case "efficiency":
+    case "performance":
+      return "efficiency";
+    case "workflow":
+    case "best-practice":
+      return "workflow";
+    case "discovery":
+      return "discovery";
+    case "architecture":
+      return "pattern";
+    // Architecture patterns map to pattern
+    default: {
+      return "pattern";
+    }
+  }
+}
+__name(normalizeLearningType, "normalizeLearningType");
+function elevateLearningToApi(storage, options) {
+  const id = storage.id ?? `learning-${Date.now()}-${Math.random().toString(36).slice(2, 9)}`;
+  const normalizedType = normalizeLearningType(storage.type);
+  const trigger = Array.isArray(storage.trigger) ? storage.trigger.join(", ") : storage.trigger;
+  let created;
+  if (typeof storage.timestamp === "string") {
+    const parsed = new Date(storage.timestamp);
+    created = Number.isNaN(parsed.getTime()) ? Date.now() : parsed.getTime();
+  } else {
+    created = storage.timestamp;
+  }
+  const confidence = storage.relevanceScore ?? (options?.relevanceBoost ?? 0.7) * (storage.accessCount ? Math.min(1, storage.accessCount / 10) : 0.5);
+  return {
+    id,
+    type: normalizedType,
+    trigger,
+    action: storage.action,
+    confidence: Math.round(confidence * 1e3) / 1e3,
+    created,
+    source: storage.source,
+    tags: storage.keywords ?? [],
+    usageCount: storage.accessCount ?? 0
+  };
+}
+__name(elevateLearningToApi, "elevateLearningToApi");
+LearningStorageSchema.transform((storage) => elevateLearningToApi(storage)).pipe(LearningApiSchema);
+
+export { LearningApiSchema };

package/dist/{chunk-7JX6Y4TL.js → chunk-DPWFZNMY.js}

@@ -1,32 +1,11 @@
 #!/usr/bin/env node --no-warnings=ExperimentalWarning
-import { __name } from './chunk-RB7H4UQJ.js';
+import { __name } from './chunk-7ADPL4Q3.js';
 import { mkdir, writeFile, access, constants, readFile, appendFile, stat } from 'fs/promises';
 import { homedir } from 'os';
 import { join, dirname } from 'path';
 import { z } from 'zod';
-import { nanoid } from 'nanoid';
 
-function generateId(prefix) {
-  const id = nanoid();
-  return prefix ? `${prefix}-${id}` : id;
-}
-__name(generateId, "generateId");
-function slugify(description, maxLength = 30) {
-  return description.toLowerCase().trim().replace(/[^a-z0-9\s-]/g, "").replace(/\s+/g, "-").replace(/-+/g, "-").replace(/^-|-$/g, "").slice(0, maxLength);
-}
-__name(slugify, "slugify");
-function generateSnapshotId(description) {
-  if (description && description.length > 0) {
-    const slug = slugify(description);
-    if (slug.length > 0) {
-      return `snapshot-${slug}-${Date.now()}-${nanoid(9)}`;
-    }
-  }
-  return `snapshot-${Date.now()}-${nanoid(9)}`;
-}
-__name(generateSnapshotId, "generateSnapshotId");
-
-// src/services/snapback-dir.ts
+process.env.SNAPBACK_CLI='true';
 var SNAPBACK_DIR = ".snapback";
 var GLOBAL_SNAPBACK_DIR = ".snapback";
 var WorkspaceConfigSchema = z.object({
@@ -259,7 +238,9 @@ async function deleteGlobalJson(relativePath) {
 __name(deleteGlobalJson, "deleteGlobalJson");
 async function getWorkspaceConfig(workspaceRoot) {
   const data = await readSnapbackJson("config.json", workspaceRoot);
-  if (!data) return null;
+  if (!data) {
+    return null;
+  }
   const result = WorkspaceConfigSchema.safeParse(data);
   return result.success ? result.data : null;
 }
@@ -270,7 +251,9 @@ async function saveWorkspaceConfig(config, workspaceRoot) {
 __name(saveWorkspaceConfig, "saveWorkspaceConfig");
 async function getWorkspaceVitals(workspaceRoot) {
   const data = await readSnapbackJson("vitals.json", workspaceRoot);
-  if (!data) return null;
+  if (!data) {
+    return null;
+  }
   const result = WorkspaceVitalsSchema.safeParse(data);
   return result.success ? result.data : null;
 }
@@ -281,7 +264,9 @@ async function saveWorkspaceVitals(vitals, workspaceRoot) {
 __name(saveWorkspaceVitals, "saveWorkspaceVitals");
 async function getProtectedFiles(workspaceRoot) {
   const data = await readSnapbackJson("protected.json", workspaceRoot);
-  if (!data) return [];
+  if (!data) {
+    return [];
+  }
   const result = z.array(ProtectedFileSchema).safeParse(data);
   return result.success ? result.data : [];
 }
@@ -292,7 +277,9 @@ async function saveProtectedFiles(files, workspaceRoot) {
 __name(saveProtectedFiles, "saveProtectedFiles");
 async function getCurrentSession(workspaceRoot) {
   const data = await readSnapbackJson("session/current.json", workspaceRoot);
-  if (!data) return null;
+  if (!data) {
+    return null;
+  }
   const result = SessionStateSchema.safeParse(data);
   return result.success ? result.data : null;
 }
@@ -330,7 +317,7 @@ async function getViolations(workspaceRoot) {
 __name(getViolations, "getViolations");
 async function getCredentials() {
   try {
-    const { getCredentialsSecure } = await import('./secure-credentials-IWQB6KU4.js');
+    const { getCredentialsSecure } = await import('./secure-credentials-UEPG7GWW.js');
     return await getCredentialsSecure();
   } catch {
     return readGlobalJson("credentials.json");
@@ -339,7 +326,7 @@ async function getCredentials() {
 __name(getCredentials, "getCredentials");
 async function saveCredentials(credentials) {
   try {
-    const { saveCredentialsSecure } = await import('./secure-credentials-IWQB6KU4.js');
+    const { saveCredentialsSecure } = await import('./secure-credentials-UEPG7GWW.js');
     return await saveCredentialsSecure(credentials);
   } catch {
     await createGlobalDirectory();
@@ -349,7 +336,7 @@ async function saveCredentials(credentials) {
 __name(saveCredentials, "saveCredentials");
 async function clearCredentials() {
   try {
-    const { clearCredentialsSecure } = await import('./secure-credentials-IWQB6KU4.js');
+    const { clearCredentialsSecure } = await import('./secure-credentials-UEPG7GWW.js');
     return await clearCredentialsSecure();
   } catch {
     await deleteGlobalJson("credentials.json");
@@ -358,7 +345,9 @@ async function clearCredentials() {
 __name(clearCredentials, "clearCredentials");
 async function getGlobalConfig() {
   const data = await readGlobalJson("config.json");
-  if (!data) return null;
+  if (!data) {
+    return null;
+  }
   const result = GlobalConfigSchema.safeParse(data);
   return result.success ? result.data : null;
 }
@@ -415,6 +404,4 @@ async function getStats(path) {
 }
 __name(getStats, "getStats");
 
-export { GlobalConfigSchema, GlobalCredentialsSchema, LearningEntrySchema, ProtectedFileSchema, SessionStateSchema, ViolationEntrySchema, WorkspaceConfigSchema, WorkspaceVitalsSchema, appendSnapbackJsonl, clearCredentials, createGlobalDirectory, createSnapbackDirectory, deleteGlobalJson, endCurrentSession, findWorkspaceRoot, generateId, generateSnapshotId, getCredentials, getCurrentSession, getGlobalConfig, getGlobalDir, getGlobalPath, getLearnings, getProtectedFiles, getStats, getViolations, getWorkspaceConfig, getWorkspaceDir, getWorkspacePath, getWorkspaceVitals, isLoggedIn, isSnapbackInitialized, loadSnapbackJsonl, pathExists, readGlobalJson, readSnapbackJson, recordLearning, recordViolation, saveCredentials, saveCurrentSession, saveGlobalConfig, saveProtectedFiles, saveWorkspaceConfig, saveWorkspaceVitals, writeGlobalJson, writeSnapbackJson };
-//# sourceMappingURL=chunk-7JX6Y4TL.js.map
-//# sourceMappingURL=chunk-7JX6Y4TL.js.map
+export { GlobalConfigSchema, GlobalCredentialsSchema, LearningEntrySchema, ProtectedFileSchema, SessionStateSchema, ViolationEntrySchema, WorkspaceConfigSchema, WorkspaceVitalsSchema, appendSnapbackJsonl, clearCredentials, createGlobalDirectory, createSnapbackDirectory, deleteGlobalJson, endCurrentSession, findWorkspaceRoot, getCredentials, getCurrentSession, getGlobalConfig, getGlobalDir, getGlobalPath, getLearnings, getProtectedFiles, getStats, getViolations, getWorkspaceConfig, getWorkspaceDir, getWorkspacePath, getWorkspaceVitals, isLoggedIn, isSnapbackInitialized, loadSnapbackJsonl, pathExists, readGlobalJson, readSnapbackJson, recordLearning, recordViolation, saveCredentials, saveCurrentSession, saveGlobalConfig, saveProtectedFiles, saveWorkspaceConfig, saveWorkspaceVitals, writeGlobalJson, writeSnapbackJson };