@ai-dossier/cli 0.2.1

package/dist/helpers.d.ts

@@ -0,0 +1,145 @@
+/**
+ * Shared helper functions and types for Dossier CLI commands.
+ * Extracted from the monolithic bin/dossier entry point.
+ */
+/** Root of the CLI package (cli/) */
+export declare const CLI_ROOT: string;
+/** The bin/ directory */
+export declare const BIN_DIR: string;
+/** Repository root (parent of cli/) */
+export declare const REPO_ROOT: string;
+/** Official KMS keys that require CI/CD signing (not direct CLI use) */
+export declare const OFFICIAL_KMS_KEYS: string[];
+/** Required frontmatter fields per schema spec */
+export declare const REQUIRED_FIELDS: string[];
+/** Recommended fields (warn if missing) */
+export declare const RECOMMENDED_FIELDS: string[];
+/** Valid values for risk_level */
+export declare const VALID_RISK_LEVELS: string[];
+/** Valid values for status */
+export declare const VALID_STATUSES: string[];
+export interface VerificationOptions {
+    skipChecksum?: boolean;
+    skipAllChecks?: boolean;
+    skipAuthorCheck?: boolean;
+    skipDossierCheck?: boolean;
+    skipRiskAssessment?: boolean;
+    skipReview?: boolean;
+    force?: boolean;
+    noPrompt?: boolean;
+    reviewDossier?: string;
+}
+export interface VerificationStage {
+    stage: number;
+    name: string;
+    passed?: boolean;
+    skipped?: boolean;
+    demo?: boolean;
+}
+export interface VerificationResult {
+    passed: boolean;
+    stages: VerificationStage[];
+}
+export interface ListSource {
+    type: 'local' | 'github';
+    path?: string;
+    owner?: string;
+    repo?: string;
+    branch?: string;
+}
+export interface DossierMetadata {
+    path: string;
+    filename: string;
+    title: string;
+    version?: string;
+    risk_level?: string;
+    category?: string;
+    status?: string;
+    signed?: boolean;
+    checksum?: boolean;
+    objective?: string;
+    error: string | null;
+}
+export interface GitHubFile {
+    path: string;
+    rawUrl: string;
+    githubUrl: string;
+}
+/**
+ * Validate a dossier name to prevent path traversal attacks.
+ * Rejects names containing '..' segments or absolute paths.
+ * @throws Error if the name is invalid.
+ */
+export declare function validateDossierName(name: string): void;
+/**
+ * Safely join a base directory with a dossier name and verify the result
+ * stays within the base directory.
+ * @throws Error if the resolved path escapes the base directory.
+ */
+export declare function safeDossierPath(baseDir: string, dossierName: string): string;
+/**
+ * Read all data from stdin (piped input) with a timeout.
+ * Returns null if stdin is a TTY (interactive terminal).
+ */
+export declare function readStdin(timeoutMs?: number): Promise<string | null>;
+/**
+ * Detect and resolve which LLM to use.
+ * @returns The resolved LLM name, or null if none detected.
+ */
+export declare function detectLlm(llmOption: string, silent?: boolean): string | null;
+export interface LlmExecDescriptor {
+    cmd: string;
+    args: string[];
+    /** If set, pipe this content to the process's stdin */
+    stdin?: string;
+    /** Human-readable description for logging */
+    description: string;
+}
+/**
+ * Download a URL to a local temp file (synchronous).
+ * Returns the temp file path.
+ */
+export declare function downloadUrlToTempFile(url: string): string;
+/**
+ * Build the execution descriptor for a given LLM.
+ * File must be a local file path (download URLs first with downloadUrlToTempFile).
+ * @returns The execution descriptor, or null for unknown LLM.
+ */
+export declare function buildLlmCommand(llm: string, file: string, headless?: boolean): LlmExecDescriptor | null;
+/**
+ * Multi-stage verification pipeline.
+ */
+export declare function runVerification(file: string, options: VerificationOptions): Promise<VerificationResult>;
+/**
+ * Recursively find all .ds.md files in a local directory.
+ */
+export declare function findDossierFilesLocal(dir: string, recursive?: boolean): string[];
+/**
+ * Parse source string to determine type and details.
+ */
+export declare function parseListSource(source: string): ListSource;
+/**
+ * Fetch GitHub repository tree and find .ds.md files.
+ */
+export declare function findDossierFilesGitHub(owner: string, repo: string, subpath: string, branch: string): Promise<GitHubFile[]>;
+/**
+ * Fetch and parse dossier metadata from a URL.
+ */
+export declare function fetchDossierMetadata(url: string, displayPath: string): Promise<DossierMetadata>;
+/**
+ * Parse dossier metadata from file content.
+ */
+export declare function parseDossierMetadataFromContent(content: string, filePath: string): DossierMetadata;
+/**
+ * Parse dossier metadata from a local file.
+ */
+export declare function parseDossierMetadataLocal(filePath: string): DossierMetadata;
+/**
+ * Verify a dossier file using the verify script (quick check).
+ */
+export declare function verifyDossierQuick(filePath: string): boolean;
+/**
+ * Format output as table.
+ */
+export declare function formatTable(dossiers: DossierMetadata[], showPath?: boolean): string;
+//# sourceMappingURL=helpers.d.ts.map

package/dist/helpers.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"helpers.d.ts","sourceRoot":"","sources":["../src/helpers.ts"],"names":[],"mappings":"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"}