@quantiya/codevibe-core 2.0.0 → 2.0.1

package/dist/structural-summary/types.d.ts

@@ -0,0 +1,215 @@
+import type { Tier } from '../orchestration-shell/types';
+/**
+ * The 6 manifest kinds detected by the first slice (§4.4), plus `other`
+ * (parser found a candidate but parsing failed) and `none` (no manifest
+ * found at this rootPath).
+ *
+ * Matches the locked `RepoSummary.manifestType` enum at CP-0 §10.S.7 line 145.
+ */
+export type ManifestType = 'npm' | 'cargo' | 'pyproject' | 'go' | 'podfile' | 'gradle' | 'other' | 'none';
+export interface ParsedManifest {
+    type: ManifestType;
+    packageName?: string;
+    dependencies: string[];
+}
+/**
+ * One directory in the walked tree. Mirrors CP-0 §10.S.7:153-160; the
+ * Max-tier `body` + `bodyTruncated` fields are `[ADDITIVE WIDENING — CP-1.d]`
+ * per Hendry-locked round-1 Q1. `truncatedByDepth` is set when the walker
+ * hits `maxDepth = 12` on this node's subtree (§4.7).
+ */
+export interface DirectoryNode {
+    path: string;
+    fileCount: number;
+    bytes: number;
+    children: DirectoryNode[];
+    inferredLanguage?: string;
+    /** `[ADDITIVE WIDENING — CP-1.d]` Q1 LOCKED — Max-tier opt-in only. */
+    body?: string;
+    /** `[ADDITIVE WIDENING — CP-1.d]` Q1 LOCKED — true if `body` truncated or skipped due to per-file 512 KiB cap or shared 64 MiB body budget. */
+    bodyTruncated?: boolean;
+    /** True if walker stopped recursing here because `maxDepth = 12` was hit on a descendant. */
+    truncatedByDepth?: boolean;
+}
+/**
+ * One repo's portion of the assembled summary. The `rootPath` ECHOES the
+ * caller-supplied (possibly symlinked) path so the user-visible digest
+ * stays stable; the walker uses `realRootPath` for internal admission
+ * checks (§4.3 step 2 step 0).
+ */
+export interface RepoSummary {
+    rootPath: string;
+    manifestType: ManifestType;
+    packageName?: string;
+    dependencies: string[];
+    inferredLanguages: string[];
+    readmePreview: string;
+    directoryTree: DirectoryNode;
+}
+/**
+ * Privacy envelope counters + status flags. All but the first 3 fields are
+ * `[ADDITIVE WIDENING — CP-1.d]` extensions to the CP-0 §10.S.7:136-140
+ * 3-field sketch (per Stage 2 r1 Codex H-1 + Gemini H-1 + Hendry-locked Q2).
+ */
+export interface PrivacyEnvelope {
+    bodyInclusionPaths: string[];
+    excludedByGitignore: number;
+    excludedByIgnoreFile: number;
+    /** `[ADDITIVE WIDENING — CP-1.d]` Stage 2 r1 Codex H-1. */
+    excludedAsUntracked?: number;
+    /** `[ADDITIVE WIDENING — CP-1.d]` Q2 LOCKED — covers both file-count AND body-byte budgets. */
+    budgetExceeded?: boolean;
+    /** `[ADDITIVE WIDENING — CP-1.d]` Stage 2 r1 Gemini H-1 — disambiguates which budget tripped first. */
+    budgetReason?: 'fileCount' | 'bodyBytes';
+    /** `[ADDITIVE WIDENING — CP-1.d]` Stage 2 r1 Codex H-1 — graceful non-git fallback marker. */
+    notInGitRepo?: boolean;
+}
+/**
+ * The top-level structural summary returned by `generate()`. CP-1.b
+ * consumes `sha256` as an opaque cache key.
+ */
+export interface StructuralSummary {
+    generatedAt: string;
+    rootPaths: string[];
+    repos: RepoSummary[];
+    totalFileCount: number;
+    totalBytes: number;
+    privacyEnvelope: PrivacyEnvelope;
+    /**
+     * Hex-encoded SHA-256 over the canonical-JSON serialization of the
+     * summary EXCLUDING BOTH the `sha256` field AND the `generatedAt`
+     * field. `generatedAt` is excluded so identical repo content →
+     * identical sha256 across runs (the CP-1.b reproducibility contract);
+     * a wall-clock timestamp would defeat that.
+     *
+     * Canonical-JSON definition: `JSON.stringify(hashPayload, canonicalReplacer)`
+     * where `canonicalReplacer` sorts object keys lexicographically.
+     * Arrays preserve order, so any input array (e.g., `directoryTree.children`,
+     * `inferredLanguages`) must be sorted deterministically upstream — see
+     * `walker.ts` (children byte-wise sort) and `generator.ts:inferLanguages`
+     * (count + name byte-wise tie-break).
+     *
+     * See `generator.ts:~200-220` for the canonical hash-payload
+     * construction. The previous co-location in `assembler.ts` no longer
+     * applies (Stage 2 IMPL r2 — assembly inlined into `generator.ts`).
+     */
+    sha256: string;
+}
+/**
+ * Caller-supplied options. Mirrors PHASE-CP-1-DESIGN.md:1590-1596.
+ *
+ * `_test_caps` is a test-only escape hatch (note the underscore prefix
+ * + the `__INTERNAL__` doc tag). Production callers MUST NOT pass it;
+ * unit tests use it to trip the file-count + body-byte budget paths
+ * without authoring 50,000-file fixtures. Added by Stage 1 r1 M-3
+ * fix to support the design §5 line 1173 test row.
+ */
+export interface GenerateOpts {
+    rootPaths: string[];
+    ignoreFile?: string;
+    includeBodies?: string[];
+    userId: string;
+    tier: Tier;
+    /** __INTERNAL__ test-only seam — see JSDoc above. */
+    _test_caps?: {
+        fileCountCap?: number;
+        bodyByteCap?: number;
+    };
+}
+export interface StructuralSummaryGenerator {
+    generate(opts: GenerateOpts): Promise<StructuralSummary>;
+}
+/**
+ * Walker return value. Carries the assembled `directoryTree` + per-rootPath
+ * audit + the exclusion state + the two-set walker-accounting ledger.
+ *
+ * `countedExactPaths` + `countedPrunedPrefixes` (round-6 split per Codex r5 M-1)
+ * are the explicit ledger the manifest dispatcher + README reader consult via
+ * `isPathAccountedFor()` to avoid double-counting. See §4.3 step 6.
+ */
+export interface WalkResult {
+    directoryTree: DirectoryNode;
+    fileExtensions: Map<string, number>;
+    excludedByGitignore: number;
+    excludedByIgnoreFile: number;
+    excludedAsUntracked: number;
+    truncated: boolean;
+    bodyBudgetExceeded: boolean;
+    notInGitRepo: boolean;
+    exclusionState: ExclusionState;
+    /**
+     * Exact absolute paths the walker enumerated + already incremented an
+     * `excludedBy*` counter for (any of gitignore/userIgnore/untracked —
+     * NOT secret, which is silent).
+     */
+    countedExactPaths: Set<string>;
+    /**
+     * Absolute directory paths the walker pruned upfront without enumerating
+     * (Step 0.5 root admission OR Step 2 child-directory prune-during-descent).
+     * Counter was incremented once per prefix.
+     */
+    countedPrunedPrefixes: Set<string>;
+}
+/**
+ * Minimal gitignore-format matcher signature — the user-ignore file is
+ * matched against this. Kept as an interface so the implementation can swap
+ * between an in-process matcher and the `ignore` npm package later without
+ * surface churn.
+ */
+export interface UserIgnoreMatcher {
+    /**
+     * Returns true if the gitignore-style ruleset matches `relativePath`.
+     * `relativePath` is path.relative(realRootPath, absolutePath), with forward
+     * slashes on POSIX.
+     *
+     * Stage 2 r2 widening (M-2, Gemini M-1): `isDir` is consulted by rules
+     * with trailing `/` (e.g., `dist/`) — they MUST NOT match a regular
+     * file. Defaults to `false`; only the walker has cheap `Dirent.isDirectory()`
+     * info and threads it through. File-only callers (manifest dispatcher,
+     * README reader) get correct semantics with the default.
+     */
+    ignores(relativePath: string, isDir?: boolean): boolean;
+}
+/**
+ * Per-rootPath exclusion state, built ONCE at walker startup. See §4.3a.
+ *
+ * `ignoredExactPaths` + `ignoredDirPrefixes` (round-6 trailing-slash partition
+ * per Codex r5 H-1) replace round-5's conflated single `ignoredPrefixes` set.
+ * `realRootPath` (round-4 Codex H-1 + Gemini H-1) canonicalises the launch
+ * root through `fs.realpath()` so symlinked launch roots produce correct
+ * subtree-membership filters.
+ */
+export interface ExclusionState {
+    rootPath: string;
+    realRootPath: string;
+    notInGitRepo: boolean;
+    repoTopLevel: string;
+    untrackedSet: Set<string>;
+    ignoredExactPaths: Set<string>;
+    ignoredDirPrefixes: Set<string>;
+    userIgnoreMatcher: UserIgnoreMatcher;
+    secretDenyList: readonly string[];
+}
+/**
+ * On-disk schema for `~/.codevibe/structural-summary.opt-in.json`. Locked
+ * at §4.6.
+ */
+export interface OptInFile {
+    schemaVersion: 1;
+    bodyInclusionPaths: string[];
+    lastUpdatedAt: string;
+    tierAtOptIn: 'MAX';
+}
+export type StructuralSummaryErrorKind = 'tier_gate' | 'fs_unreadable' | 'budget_exceeded' | 'manifest_parse'
+/**
+ * `[ADDITIVE WIDENING — CP-1.d]` Stage 2 r2 Codex H-1.
+ * Thrown when a body-inclusion opt-in path is not absolute, or when
+ * realpath resolution fails (ENOENT etc.) — prevents PRIVACY REGRESSION
+ * where a relative opt-in could leak raw bodies from an unrelated
+ * repo's directory of the same name on a future `cd`.
+ */
+ | 'invalid_path';
+export declare class StructuralSummaryError extends Error {
+    readonly kind: StructuralSummaryErrorKind;
+    constructor(message: string, kind: StructuralSummaryErrorKind);
+}

package/dist/structural-summary/user-ignore-matcher.d.ts

@@ -0,0 +1,9 @@
+import type { UserIgnoreMatcher } from './types';
+/**
+ * Builds a matcher from a gitignore-format text blob.
+ */
+export declare function compileUserIgnore(text: string): UserIgnoreMatcher;
+/**
+ * Returns a no-op matcher (no rules — admits everything).
+ */
+export declare function emptyUserIgnoreMatcher(): UserIgnoreMatcher;

package/dist/structural-summary/walker.d.ts

@@ -0,0 +1,20 @@
+import type { WalkResult } from './types';
+export interface WalkOpts {
+    rootPath: string;
+    ignoreFile?: string;
+    includeBodies: string[];
+    maxDepth: number;
+    /** Shared file-count budget (mutated in-place across rootPaths). */
+    fileCountBudget: {
+        remaining: number;
+    };
+    /** Shared body-byte budget (mutated in-place across rootPaths). */
+    bodyBudget: {
+        remaining: number;
+    };
+}
+/**
+ * Walks `rootPath` and returns a `WalkResult`. Mutates the shared
+ * `fileCountBudget` + `bodyBudget` counters.
+ */
+export declare function walk(opts: WalkOpts): Promise<WalkResult>;

package/dist/types/events.d.ts

@@ -1,5 +1,11 @@
 /**
- * Event types matching GraphQL schema
+ * Event types matching GraphQL schema.
+ *
+ * 1.x values come first. CP-1 adds 9 new values per
+ * `codevibe-backend/docs/2.0/PHASE-CP-1-DESIGN.md` §3 lines 138-148 +
+ * §16 Stage A LOCK. Emission of CP-1 values is gated by the
+ * `new-event-types-enabled` cohort flag (default OFF — Phase 4 flips
+ * per-user once mobile decoders ship).
  */
 export declare enum EventType {
     USER_PROMPT = "USER_PROMPT",
@@ -8,7 +14,16 @@ export declare enum EventType {
     NOTIFICATION = "NOTIFICATION",
     INTERACTIVE_PROMPT = "INTERACTIVE_PROMPT",
     PROMPT_RESPONSE = "PROMPT_RESPONSE",
-    REASONING = "REASONING"
+    REASONING = "REASONING",
+    MODE_SELECTED = "MODE_SELECTED",
+    PLANNER_DECISION = "PLANNER_DECISION",
+    PLANNER_CACHE_HIT = "PLANNER_CACHE_HIT",
+    PLANNER_DEGRADED = "PLANNER_DEGRADED",
+    PLANNER_OUTAGE = "PLANNER_OUTAGE",
+    PLANNER_RECOVERED = "PLANNER_RECOVERED",
+    SLASH_COMMAND_INVOKED = "SLASH_COMMAND_INVOKED",
+    STRUCTURAL_SUMMARY_GENERATED = "STRUCTURAL_SUMMARY_GENERATED",
+    LOCAL_AUTHORITY_REFUSAL = "LOCAL_AUTHORITY_REFUSAL"
 }
 export declare enum EventSource {
     DESKTOP = "DESKTOP",

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@quantiya/codevibe-core",
-  "version": "2.0.0",
+  "version": "2.0.1",
   "description": "Core library for CodeVibe plugins - shared keychain, crypto, AppSync, and auth functionality",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",
@@ -10,12 +10,13 @@
   "files": [
     "dist/**/*.d.ts",
     "dist/index.js",
+    "dist/orchestration-shell/cli.js",
     "bin"
   ],
   "scripts": {
     "typecheck": "tsc --noEmit",
     "emit-types": "tsc --emitDeclarationOnly",
-    "build": "rm -rf dist && npm run emit-types && esbuild src/index.ts --bundle --platform=node --target=node18 --minify --packages=external --outfile=dist/index.js",
+    "build": "rm -rf dist && npm run emit-types && esbuild src/index.ts --bundle --platform=node --target=node18 --minify --packages=external --outfile=dist/index.js && esbuild src/orchestration-shell/cli.ts --bundle --platform=node --target=node18 --packages=external --outfile=dist/orchestration-shell/cli.js --banner:js=\"#!/usr/bin/env node\"",
     "clean": "rm -rf dist",
     "prepublishOnly": "npm run build",
     "test": "vitest run",
@@ -23,17 +24,30 @@
     "test:live": "QUORUM_LIVE_SMOKE=1 vitest run"
   },
   "dependencies": {
+    "@iarna/toml": "^2.2.5",
+    "@npmcli/package-json": "^5.2.1",
+    "gradient-string": "^3.0.0",
+    "ink": "^5.2.1",
+    "ink-select-input": "^6.2.0",
+    "ink-spinner": "^5.0.0",
+    "ink-text-input": "^6.0.0",
+    "react": "^18.3.1",
+    "ulid": "^3.0.0",
     "uuid": "^9.0.0",
-    "ws": "^8.14.0"
+    "ws": "^8.14.0",
+    "zod": "^3.23.0"
   },
   "optionalDependencies": {
     "keytar": "^7.9.0"
   },
   "devDependencies": {
+    "@types/gradient-string": "^1.1.6",
     "@types/node": "^20.0.0",
+    "@types/react": "^18.3.0",
     "@types/uuid": "^9.0.0",
     "@types/ws": "^8.5.0",
     "esbuild": "^0.28.0",
+    "ink-testing-library": "^4.0.0",
     "typescript": "^5.0.0",
     "vitest": "^1.6.1"
   },