@vibe-engineer/adapter-pi 0.1.0

package/dist/create-consumption/index.d.ts

@@ -0,0 +1,56 @@
+import { SkillId, ValidationIssue, GeneratedFileManifest, AdapterCapabilityMatrix } from '../schema/index.js';
+
+declare const CREATE_PI_ASSET_FAMILIES: readonly ["pi-skill-files", "pi-prompt-templates"];
+type CreatePiAssetFamilyId = (typeof CREATE_PI_ASSET_FAMILIES)[number];
+type CreatePiAssetKind = "skill" | "prompt-template";
+type CreatePiAssetConflictPolicy = "fail-on-conflict" | "allow-identical-overwrite";
+type CreatePiAssetExistingPathKind = "missing" | "file" | "directory" | "symlink";
+interface CreatePiAssetDescriptor {
+    readonly kind: CreatePiAssetKind;
+    readonly familyId: CreatePiAssetFamilyId;
+    readonly skillId: SkillId;
+    readonly path: string;
+    readonly shippedTemplatePath: string;
+    readonly manifestPathPattern: string;
+}
+interface CreatePiAssetPlannedWrite extends CreatePiAssetDescriptor {
+    readonly content: string;
+}
+interface CreatePiAssetExistingPathState {
+    readonly path: string;
+    readonly kind: CreatePiAssetExistingPathKind;
+    readonly currentContent?: string;
+}
+interface CreatePiAssetWritePlan {
+    readonly conflictPolicy: CreatePiAssetConflictPolicy;
+    readonly writes: readonly CreatePiAssetPlannedWrite[];
+    readonly families: readonly CreatePiAssetFamilyId[];
+}
+interface CreatePiAssetValidationIssue extends ValidationIssue {
+    readonly severity: "error";
+}
+type CreatePiAssetValidationResult<T> = {
+    readonly valid: true;
+    readonly value: T;
+    readonly issues: readonly [];
+} | {
+    readonly valid: false;
+    readonly issues: readonly CreatePiAssetValidationIssue[];
+};
+declare const selectCreatePiAssets: (input?: {
+    readonly manifest?: GeneratedFileManifest;
+    readonly capabilityMatrix?: AdapterCapabilityMatrix;
+}) => readonly CreatePiAssetDescriptor[];
+declare class CreatePiAssetValidationError extends Error {
+    readonly issues: readonly CreatePiAssetValidationIssue[];
+    constructor(message: string, issues: readonly CreatePiAssetValidationIssue[]);
+}
+declare const validateCreatePiAssetWritePlan: (input: {
+    readonly manifest: GeneratedFileManifest;
+    readonly capabilityMatrix: AdapterCapabilityMatrix;
+    readonly writes: readonly CreatePiAssetPlannedWrite[];
+    readonly existingPaths: readonly CreatePiAssetExistingPathState[];
+    readonly conflictPolicy: CreatePiAssetConflictPolicy;
+}) => CreatePiAssetValidationResult<CreatePiAssetWritePlan>;
+
+export { CREATE_PI_ASSET_FAMILIES, type CreatePiAssetConflictPolicy, type CreatePiAssetDescriptor, type CreatePiAssetExistingPathKind, type CreatePiAssetExistingPathState, type CreatePiAssetFamilyId, type CreatePiAssetKind, type CreatePiAssetPlannedWrite, CreatePiAssetValidationError, type CreatePiAssetValidationIssue, type CreatePiAssetValidationResult, type CreatePiAssetWritePlan, selectCreatePiAssets, validateCreatePiAssetWritePlan };

package/dist/create-consumption/index.js

@@ -0,0 +1,14 @@
+import {
+  CREATE_PI_ASSET_FAMILIES,
+  CreatePiAssetValidationError,
+  selectCreatePiAssets,
+  validateCreatePiAssetWritePlan
+} from "../chunk-PJHJYGIJ.js";
+import "../chunk-RC3EILIE.js";
+import "../chunk-VXZJPOEE.js";
+export {
+  CREATE_PI_ASSET_FAMILIES,
+  CreatePiAssetValidationError,
+  selectCreatePiAssets,
+  validateCreatePiAssetWritePlan
+};

package/dist/generated-file-manifest/index.d.ts

@@ -0,0 +1,10 @@
+import { GeneratedFileManifest, DownstreamManifestSummary, ValidationResult } from '../schema/index.js';
+export { CREATE_PI_ASSET_FAMILIES, CreatePiAssetConflictPolicy, CreatePiAssetDescriptor, CreatePiAssetExistingPathKind, CreatePiAssetExistingPathState, CreatePiAssetFamilyId, CreatePiAssetKind, CreatePiAssetPlannedWrite, CreatePiAssetValidationError, CreatePiAssetValidationIssue, CreatePiAssetValidationResult, CreatePiAssetWritePlan, selectCreatePiAssets, validateCreatePiAssetWritePlan } from '../create-consumption/index.js';
+
+declare const PI_GENERATED_FILE_MANIFEST_SCHEMA_VERSION: "pi-generated-file-manifest/v1";
+declare const PI_GENERATED_FILE_MANIFEST: GeneratedFileManifest;
+declare const getPiGeneratedFileManifest: () => GeneratedFileManifest;
+declare const validatePiGeneratedFileManifest: (value: unknown) => ValidationResult<GeneratedFileManifest>;
+declare const createPiDownstreamManifestSummary: () => DownstreamManifestSummary;
+
+export { PI_GENERATED_FILE_MANIFEST, PI_GENERATED_FILE_MANIFEST_SCHEMA_VERSION, createPiDownstreamManifestSummary, getPiGeneratedFileManifest, validatePiGeneratedFileManifest };

package/dist/generated-file-manifest/index.js

@@ -0,0 +1,24 @@
+import {
+  CREATE_PI_ASSET_FAMILIES,
+  CreatePiAssetValidationError,
+  PI_GENERATED_FILE_MANIFEST,
+  PI_GENERATED_FILE_MANIFEST_SCHEMA_VERSION,
+  createPiDownstreamManifestSummary,
+  getPiGeneratedFileManifest,
+  selectCreatePiAssets,
+  validateCreatePiAssetWritePlan,
+  validatePiGeneratedFileManifest
+} from "../chunk-PJHJYGIJ.js";
+import "../chunk-RC3EILIE.js";
+import "../chunk-VXZJPOEE.js";
+export {
+  CREATE_PI_ASSET_FAMILIES,
+  CreatePiAssetValidationError,
+  PI_GENERATED_FILE_MANIFEST,
+  PI_GENERATED_FILE_MANIFEST_SCHEMA_VERSION,
+  createPiDownstreamManifestSummary,
+  getPiGeneratedFileManifest,
+  selectCreatePiAssets,
+  validateCreatePiAssetWritePlan,
+  validatePiGeneratedFileManifest
+};

package/dist/schema/index.d.ts

@@ -0,0 +1,214 @@
+declare const EVIDENCE_STATES: readonly ["known", "unknown", "deferred", "blocked"];
+declare const READINESS_STATES: readonly ["ready", "unknown", "deferred", "blocked"];
+declare const SKILL_IDS: readonly ["brainstorm", "grill-me", "task", "plan", "build", "ship"];
+declare const GENERATED_FILE_FAMILY_IDS: readonly ["pi-skill-files", "pi-prompt-templates", "pi-extensions", "pi-package-manifest", "context-files", "harness-config"];
+declare const SANDBOX_CAPABILITY_STATES: readonly ["proven", "not_provided", "unknown", "blocked", "pending-live"];
+declare const I14A_RUNTIME_EXECUTION_CLAIMS: readonly ["not-claimed", "pending-live", "blocked"];
+declare const I14A_OUT_OF_SCOPE_RUNTIME_EXECUTION_CLAIMS: readonly ["proven", "live-proven", "runtime-proven", "loaded", "executed"];
+declare const GENERATED_FILE_PRODUCER_LANE_IDS: readonly ["I-14B-pi-adapter-runtime-skill-consumption", "I-15A-create-import-cli-ux-selected-harness"];
+declare const GENERATED_FILE_CONSUMER_LANE_IDS: readonly ["I-08-context-graph-index-drift", "I-14B-pi-adapter-runtime-skill-consumption", "I-15A-create-import-cli-ux-selected-harness", "I-15B-starter-template-harness-consumption", "I-18-security-safety-hooks-policy", "I-21-build-skill-orchestration"];
+type EvidenceState = (typeof EVIDENCE_STATES)[number];
+type ReadinessState = (typeof READINESS_STATES)[number];
+type SkillId = (typeof SKILL_IDS)[number];
+type GeneratedFileFamilyId = (typeof GENERATED_FILE_FAMILY_IDS)[number];
+type SandboxCapabilityState = (typeof SANDBOX_CAPABILITY_STATES)[number];
+type I14ARuntimeExecutionClaim = (typeof I14A_RUNTIME_EXECUTION_CLAIMS)[number];
+type GeneratedFileProducerLaneId = (typeof GENERATED_FILE_PRODUCER_LANE_IDS)[number];
+type GeneratedFileConsumerLaneId = (typeof GENERATED_FILE_CONSUMER_LANE_IDS)[number];
+interface ValidationIssue {
+    readonly path: string;
+    readonly code: string;
+    readonly message: string;
+}
+type ValidationResult<T> = {
+    readonly valid: true;
+    readonly value: T;
+    readonly issues: readonly [];
+} | {
+    readonly valid: false;
+    readonly issues: readonly ValidationIssue[];
+};
+interface EvidenceRecord {
+    readonly state: EvidenceState;
+    readonly source: string;
+    readonly notes: string;
+}
+interface VersionCompatibility {
+    readonly harnessName: string;
+    readonly harnessVersionRange: string;
+    readonly resourceFormatVersion: string;
+    readonly runtimeRequirements: readonly string[];
+    readonly compatibilityEvidence: EvidenceRecord;
+}
+interface CapabilitySurface {
+    readonly evidence: EvidenceRecord;
+    readonly support: ReadinessState;
+    readonly details: string;
+    readonly downstreamConsequence: string;
+}
+interface SkillCapability {
+    readonly skillId: SkillId;
+    readonly nativeCommand: string;
+    readonly resourceFamily: GeneratedFileFamilyId;
+    readonly evidence: EvidenceRecord;
+    readonly readiness: ReadinessState;
+    readonly protocolSource: string;
+}
+interface SkillsCommandsSurface extends CapabilitySurface {
+    readonly nativeFormat: string;
+    readonly autoloadDiscovery: readonly string[];
+    readonly skills: readonly SkillCapability[];
+}
+interface SubagentCapability extends CapabilitySurface {
+    readonly implementationKind: "built-in" | "extension-built" | "external" | "unsupported";
+    readonly requiresGeneratedExtension: boolean;
+}
+interface PlanModeCapability extends CapabilitySurface {
+    readonly implementationKind: "built-in" | "extension-built" | "external" | "unsupported";
+    readonly requiresGeneratedExtension: boolean;
+}
+interface CommandInvocationModel {
+    readonly interactive: CapabilitySurface;
+    readonly printMode: CapabilitySurface;
+    readonly jsonMode: CapabilitySurface;
+    readonly rpcMode: CapabilitySurface;
+    readonly sdk: CapabilitySurface;
+    readonly shellCommandPolicy: "not-required" | "default-deny" | "blocked";
+}
+interface GeneratedFilesCapability {
+    readonly evidence: EvidenceRecord;
+    readonly manifestSchemaVersion: string;
+    readonly families: readonly GeneratedFileFamilyId[];
+    readonly downstreamConsequence: string;
+}
+interface PackageDistributionCapability extends CapabilitySurface {
+    readonly distributionKinds: readonly ("project-local-files" | "pi-package" | "npm-package" | "global-install")[];
+    readonly trustUpdatePolicy: string;
+}
+interface SecurityTrustCapability {
+    readonly evidence: EvidenceRecord;
+    readonly projectTrustRequired: boolean;
+    readonly extensionExecution: "none" | "typescript-extension" | "package-extension";
+    readonly commandPolicy: "default-deny" | "not-applicable";
+    readonly sandboxCapability: SandboxCapabilityState;
+    readonly credentialPolicy: "no-credentials-required" | "operator-supplied-only" | "unknown-blocked";
+    readonly destructiveOperations: "forbidden" | "approval-required" | "not-applicable";
+    readonly externalIntegration: "disabled-by-default" | "read-only" | "unknown-blocked";
+    readonly trustBoundary: string;
+}
+interface CapabilityFlags {
+    readonly skills: boolean;
+    readonly prompts: boolean;
+    readonly hooks: boolean;
+    readonly extensions: boolean;
+    readonly subagents: boolean;
+    readonly planMode: boolean;
+    readonly contextFiles: boolean;
+    readonly rpc: boolean;
+    readonly sdk: boolean;
+    readonly jsonMode: boolean;
+    readonly packages: boolean;
+    readonly ui: boolean;
+    readonly unsupportedFeaturePolicy: "block" | "defer" | "unknown-block";
+}
+interface RealBoundaryWitness {
+    readonly evidence: EvidenceRecord;
+    readonly boundaryStatus: "implemented" | "pending-live" | "blocked" | "deferred" | "unknown";
+    readonly producer: string;
+    readonly carrier: string;
+    readonly consumer: string;
+    readonly evidencePath: string;
+    readonly runtimeExecutionClaim: I14ARuntimeExecutionClaim;
+}
+interface AdapterSelectionStatus {
+    readonly manifestSelectable: boolean;
+    readonly createImportSelectable: boolean;
+    readonly readiness: ReadinessState;
+    readonly reason: string;
+}
+interface AdapterCapability {
+    readonly adapterId: string;
+    readonly displayName: string;
+    readonly evidenceStatus: EvidenceRecord;
+    readonly versionCompatibility: VersionCompatibility;
+    readonly skillsCommandsSurface: SkillsCommandsSurface;
+    readonly promptTemplateSurface: CapabilitySurface;
+    readonly hookEventSupport: CapabilitySurface;
+    readonly subagentCapability: SubagentCapability;
+    readonly planModeCapability: PlanModeCapability;
+    readonly contextFileConventions: CapabilitySurface;
+    readonly commandInvocationModel: CommandInvocationModel;
+    readonly generatedFiles: GeneratedFilesCapability;
+    readonly packageDistribution: PackageDistributionCapability;
+    readonly securityTrust: SecurityTrustCapability;
+    readonly capabilityFlags: CapabilityFlags;
+    readonly realBoundaryWitness: RealBoundaryWitness;
+    readonly selection: AdapterSelectionStatus;
+}
+interface AdapterCapabilityMatrix {
+    readonly schemaVersion: "pi-adapter-capability-matrix/v1";
+    readonly producedByLane: "I-14A-pi-adapter-capability-generated-file-manifest";
+    readonly adapterPackage: "@vibe-engineer/adapter-pi";
+    readonly adapters: readonly AdapterCapability[];
+}
+interface GeneratedFileOwner {
+    readonly ownerKind: "lane" | "package";
+    readonly ownerId: GeneratedFileProducerLaneId;
+    readonly writePathScope: readonly string[];
+    readonly allowedOperations: readonly ("declare" | "validate" | "generate-in-later-lane")[];
+}
+interface GeneratedFileTrustSecurity {
+    readonly classification: "project-instruction" | "executable-extension" | "package-manifest" | "configuration";
+    readonly trustBoundary: string;
+    readonly projectTrustRequired: boolean;
+    readonly executesCode: boolean;
+    readonly commandPolicy: "default-deny" | "not-applicable";
+    readonly sandboxCapability: SandboxCapabilityState;
+    readonly credentialPolicy: "no-credentials-required" | "operator-supplied-only" | "unknown-blocked";
+    readonly externalIntegration: "disabled-by-default" | "read-only" | "unknown-blocked";
+    readonly destructiveOperationPolicy: "forbidden" | "approval-required" | "not-applicable";
+    readonly evidence: EvidenceRecord;
+}
+interface GeneratedFileVersion {
+    readonly formatName: string;
+    readonly formatVersion: string;
+    readonly schemaVersion: "pi-generated-file-manifest/v1";
+    readonly adapterCapabilityVersion: "pi-adapter-capability-matrix/v1";
+}
+interface GeneratedFileReadiness {
+    readonly state: ReadinessState;
+    readonly reason: string;
+}
+interface GeneratedFileFamily {
+    readonly familyId: GeneratedFileFamilyId;
+    readonly description: string;
+    readonly pathPatterns: readonly string[];
+    readonly owner: GeneratedFileOwner;
+    readonly producedByLane: GeneratedFileProducerLaneId;
+    readonly consumedByLanes: readonly GeneratedFileConsumerLaneId[];
+    readonly trustSecurity: GeneratedFileTrustSecurity;
+    readonly version: GeneratedFileVersion;
+    readonly readiness: GeneratedFileReadiness;
+}
+interface GeneratedFileManifest {
+    readonly schemaVersion: "pi-generated-file-manifest/v1";
+    readonly adapterId: "pi";
+    readonly adapterCapabilityVersion: "pi-adapter-capability-matrix/v1";
+    readonly producedByLane: "I-14A-pi-adapter-capability-generated-file-manifest";
+    readonly families: readonly GeneratedFileFamily[];
+}
+interface DownstreamManifestSummary {
+    readonly schemaVersion: "pi-adapter-downstream-summary/v1";
+    readonly adapterId: "pi";
+    readonly sixSkills: readonly SkillId[];
+    readonly generatedFamilies: readonly GeneratedFileFamilyId[];
+    readonly manifestReady: boolean;
+    readonly createImportReady: false;
+    readonly runtimeExecutionClaim: I14ARuntimeExecutionClaim;
+    readonly blockedNonPiAdapters: readonly string[];
+}
+declare const validateCapabilityMatrix: (value: unknown) => ValidationResult<AdapterCapabilityMatrix>;
+declare const validateGeneratedFileManifest: (value: unknown) => ValidationResult<GeneratedFileManifest>;
+declare const createDownstreamManifestSummary: (capabilityMatrix: AdapterCapabilityMatrix, generatedFileManifest: GeneratedFileManifest) => DownstreamManifestSummary;
+
+export { type AdapterCapability, type AdapterCapabilityMatrix, type AdapterSelectionStatus, type CapabilityFlags, type CapabilitySurface, type CommandInvocationModel, type DownstreamManifestSummary, EVIDENCE_STATES, type EvidenceRecord, type EvidenceState, GENERATED_FILE_CONSUMER_LANE_IDS, GENERATED_FILE_FAMILY_IDS, GENERATED_FILE_PRODUCER_LANE_IDS, type GeneratedFileConsumerLaneId, type GeneratedFileFamily, type GeneratedFileFamilyId, type GeneratedFileManifest, type GeneratedFileOwner, type GeneratedFileProducerLaneId, type GeneratedFileReadiness, type GeneratedFileTrustSecurity, type GeneratedFileVersion, type GeneratedFilesCapability, type I14ARuntimeExecutionClaim, I14A_OUT_OF_SCOPE_RUNTIME_EXECUTION_CLAIMS, I14A_RUNTIME_EXECUTION_CLAIMS, type PackageDistributionCapability, type PlanModeCapability, READINESS_STATES, type ReadinessState, type RealBoundaryWitness, SANDBOX_CAPABILITY_STATES, SKILL_IDS, type SandboxCapabilityState, type SecurityTrustCapability, type SkillCapability, type SkillId, type SkillsCommandsSurface, type SubagentCapability, type ValidationIssue, type ValidationResult, type VersionCompatibility, createDownstreamManifestSummary, validateCapabilityMatrix, validateGeneratedFileManifest };

package/dist/schema/index.js

@@ -0,0 +1,28 @@
+import {
+  EVIDENCE_STATES,
+  GENERATED_FILE_CONSUMER_LANE_IDS,
+  GENERATED_FILE_FAMILY_IDS,
+  GENERATED_FILE_PRODUCER_LANE_IDS,
+  I14A_OUT_OF_SCOPE_RUNTIME_EXECUTION_CLAIMS,
+  I14A_RUNTIME_EXECUTION_CLAIMS,
+  READINESS_STATES,
+  SANDBOX_CAPABILITY_STATES,
+  SKILL_IDS,
+  createDownstreamManifestSummary,
+  validateCapabilityMatrix,
+  validateGeneratedFileManifest
+} from "../chunk-VXZJPOEE.js";
+export {
+  EVIDENCE_STATES,
+  GENERATED_FILE_CONSUMER_LANE_IDS,
+  GENERATED_FILE_FAMILY_IDS,
+  GENERATED_FILE_PRODUCER_LANE_IDS,
+  I14A_OUT_OF_SCOPE_RUNTIME_EXECUTION_CLAIMS,
+  I14A_RUNTIME_EXECUTION_CLAIMS,
+  READINESS_STATES,
+  SANDBOX_CAPABILITY_STATES,
+  SKILL_IDS,
+  createDownstreamManifestSummary,
+  validateCapabilityMatrix,
+  validateGeneratedFileManifest
+};

package/package.json

@@ -0,0 +1,61 @@
+{
+  "name": "@vibe-engineer/adapter-pi",
+  "version": "0.1.0",
+  "license": "MIT",
+  "type": "module",
+  "description": "Pi harness adapter templates, capability metadata, and generated-file validation for vibe-engineer.",
+  "private": false,
+  "engines": {
+    "node": ">=20.19.0",
+    "pnpm": ">=10.33.0"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/ismailsaleekh/vibe-engineer.git"
+  },
+  "exports": {
+    "./capabilities": {
+      "types": "./dist/capabilities/index.d.ts",
+      "import": "./dist/capabilities/index.js"
+    },
+    "./generated-file-manifest": {
+      "types": "./dist/generated-file-manifest/index.d.ts",
+      "import": "./dist/generated-file-manifest/index.js"
+    },
+    "./create-consumption": {
+      "types": "./dist/create-consumption/index.d.ts",
+      "import": "./dist/create-consumption/index.js"
+    },
+    "./schema": {
+      "types": "./dist/schema/index.d.ts",
+      "import": "./dist/schema/index.js"
+    }
+  },
+  "files": [
+    "dist"
+  ],
+  "scripts": {
+    "build": "tsup",
+    "typecheck": "tsc --noEmit --allowImportingTsExtensions --module NodeNext --moduleResolution NodeNext --target ES2022 --lib ES2022 --strict --noImplicitAny --strictNullChecks --strictFunctionTypes --strictBindCallApply --strictPropertyInitialization --noImplicitThis --alwaysStrict --exactOptionalPropertyTypes --noUncheckedIndexedAccess --noImplicitOverride --noImplicitReturns --noPropertyAccessFromIndexSignature --useUnknownInCatchVariables --noFallthroughCasesInSwitch --noUnusedLocals --noUnusedParameters --allowUnreachableCode false --allowUnusedLabels false --isolatedModules --verbatimModuleSyntax --forceConsistentCasingInFileNames --skipLibCheck src/capabilities/index.ts src/generated-file-manifest/index.ts src/create-consumption/index.ts src/schema/index.ts"
+  },
+  "vibeEngineer": {
+    "implementationUnit": "I-14A-pi-adapter-capability-generated-file-manifest",
+    "implementationStatus": "v0.1-public-pi-adapter",
+    "packageRole": "public-pi-adapter-package",
+    "sourceStatus": "v0.1-pi-assets-and-manifest-validated"
+  },
+  "author": "Ismail <ismailsalikhodjaev@gmail.com>",
+  "bugs": {
+    "url": "https://github.com/ismailsaleekh/vibe-engineer/issues"
+  },
+  "homepage": "https://github.com/ismailsaleekh/vibe-engineer#readme",
+  "keywords": [
+    "ai",
+    "agents",
+    "typescript",
+    "verification",
+    "schematics",
+    "developer-tools",
+    "vibe-engineer"
+  ]
+}