@karmaniverous/stan-core 0.9.4 → 0.10.1

package/dist/types/index.d.ts

@@ -127,6 +127,20 @@ type CreateArchiveFromFilesOptions = {
     /** Optional callback for a deterministic selection report (engine remains silent by default). */
     onSelectionReport?: (report: SelectionReport) => void;
 };
+/**
+ * Create `stanPath/output/archive.tar` (or custom file name) from an explicit
+ * allowlist of repo-relative paths.
+ *
+ * This is used by context mode, where archive selection must be allowlist-only
+ * rather than the default denylist-driven selection.
+ *
+ * @param cwd - Repo root.
+ * @param stanPath - STAN workspace folder.
+ * @param relFiles - Repo-relative POSIX paths to include (files only).
+ * @param options - See {@link CreateArchiveFromFilesOptions}.
+ * @returns Absolute path to the created tar.
+ */
+declare function createArchiveFromFiles(cwd: string, stanPath: string, relFiles: string[], options?: CreateArchiveFromFilesOptions): Promise<string>;
 
 /**
  * Creates a "meta" archive (system docs + dependency meta/state, plus optional
@@ -712,6 +726,7 @@ declare const createArchiveDiffWithDependencyContext: (args: {
         updateSnapshot?: SnapshotUpdateMode;
         includeOutputDirInDiff?: boolean;
         onArchiveWarnings?: (text: string) => void;
+        onSelectionReport?: (report: SelectionReport) => void;
     };
 }) => Promise<CreateArchiveDiffWithDependencyContextResult>;
 
@@ -829,7 +844,7 @@ declare const buildDependencyMeta: (args: BuildDependencyMetaArgs) => Promise<Bu
  * @module
  */
 
-type CreateContextArchiveOptions = Pick<CreateArchiveFromFilesOptions, 'fileName' | 'onArchiveWarnings'> & {
+type CreateContextArchiveOptions = Pick<CreateArchiveFromFilesOptions, 'fileName' | 'onArchiveWarnings' | 'onSelectionReport'> & {
     /** Context mode should remain allowlist-only; output dir inclusion is rarely desired. */
     includeOutputDir?: false;
 };
@@ -871,6 +886,7 @@ declare const createContextArchiveDiffWithDependencyContext: (args: {
         snapshotFileName?: string;
         includeOutputDirInDiff?: boolean;
         onArchiveWarnings?: (text: string) => void;
+        onSelectionReport?: (report: SelectionReport) => void;
     };
 }) => Promise<CreateContextArchiveDiffResult>;
 
@@ -995,5 +1011,5 @@ declare const assembleSystemMonolith: (cwd: string, stanPath: string) => Promise
 
 declare const CORE_VERSION: string;
 
-export { CORE_VERSION, DEFAULT_OPEN_COMMAND, DEFAULT_STAN_PATH, applyPatchPipeline, applyWithJsDiff, assembleSystemMonolith, buildDependencyMeta, computeContextAllowlistPlan, computeSelectedNodeIds, createArchive, createArchiveDiff, createArchiveDiffFromFiles, createArchiveDiffWithDependencyContext, createArchiveWithDependencyContext, createContextArchiveDiffWithDependencyContext, createContextArchiveWithDependencyContext, createMetaArchive, dependencyMapFileSchema, dependencyMapNodeSchema, dependencyMetaFileSchema, dependencyMetaNodeSchema, dependencyStateEntrySchema, dependencyStateFileSchema, detectAndCleanPatch, ensureOutputDir, executeFileOps, expandEntry, findConfigPathSync, getPackagedSystemPromptPath, loadConfig, loadConfigSync, makeGlobMatcher, parseDependencyStateFile, parseFileOpsBlock, prepareDependencyContext, prepareImports, resolveStanPath, resolveStanPathSync, stageDependencyContext, stagePreparedDependencyContext, summarizeContextAllowlistBudget, validateDependencySelection, validateDependencySelectionOrThrow, writeArchiveSnapshot, writeArchiveSnapshotFromFiles, writeDependencyMapFile, writeDependencyMetaFile };
+export { CORE_VERSION, DEFAULT_OPEN_COMMAND, DEFAULT_STAN_PATH, applyPatchPipeline, applyWithJsDiff, assembleSystemMonolith, buildDependencyMeta, computeContextAllowlistPlan, computeSelectedNodeIds, createArchive, createArchiveDiff, createArchiveDiffFromFiles, createArchiveDiffWithDependencyContext, createArchiveFromFiles, createArchiveWithDependencyContext, createContextArchiveDiffWithDependencyContext, createContextArchiveWithDependencyContext, createMetaArchive, dependencyMapFileSchema, dependencyMapNodeSchema, dependencyMetaFileSchema, dependencyMetaNodeSchema, dependencyStateEntrySchema, dependencyStateFileSchema, detectAndCleanPatch, ensureOutputDir, executeFileOps, expandEntry, findConfigPathSync, getPackagedSystemPromptPath, loadConfig, loadConfigSync, makeGlobMatcher, parseDependencyStateFile, parseFileOpsBlock, prepareDependencyContext, prepareImports, resolveStanPath, resolveStanPathSync, stageDependencyContext, stagePreparedDependencyContext, summarizeContextAllowlistBudget, validateDependencySelection, validateDependencySelectionOrThrow, writeArchiveSnapshot, writeArchiveSnapshotFromFiles, writeDependencyMapFile, writeDependencyMetaFile };
 export type { ApplyResult, AssembleResult, AttemptCapture, BudgetEntry, BudgetSource, BuildDependencyMetaArgs, BuildDependencyMetaResult, ContextAllowlistBudget, ContextAllowlistPlan, ContextConfig, ContextModeSelection, CreateArchiveDiffWithDependencyContextResult, CreateArchiveFromFilesOptions, CreateArchiveOptions, CreateArchiveWithDependencyContextResult, CreateContextArchiveDiffResult, CreateContextArchiveOptions, CreateContextArchiveResult, DependencyContextInputs, DependencyMapFile, DependencyMapNode, DependencyMetaFile, DependencyMetaNode, DependencyStateEntry, DependencyStateFile, DependencyValidationMismatch, FileOp, FileOpsPlan, ImportsMap, JsDiffOutcome, NodeSource, NormalizedDependencyStateEntry, OpResult, PipelineOutcome, PrepareDependencyContextResult, SelectionReport, SelectionReportCounts, SnapshotUpdateMode, StageDependencyContextArgs, StageDependencyContextResult, StagePreparedDependencyContextResult, StagedEntry, ValidateDependencySelectionResult };

package/package.json

@@ -151,5 +151,5 @@
   },
   "type": "module",
   "types": "dist/types/index.d.ts",
-  "version": "0.9.4"
+  "version": "0.10.1"
 }