squadfoundry 0.1.0

package/dist/orchestrator/adapters/publishing/ISocialMediaAdapter.d.ts.map

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

package/dist/orchestrator/adapters/publishing/ISocialMediaAdapter.js

@@ -0,0 +1,10 @@
+/**
+ * ISocialMediaAdapter — Social Media Publishing Adapter Interface
+ *
+ * Abstracts publishing operations across social media platforms
+ * (Instagram, Twitter/X, LinkedIn, TikTok, etc.).
+ *
+ * STATUS: Interface defined. Concrete adapters: instagram (stub)
+ */
+export {};
+//# sourceMappingURL=ISocialMediaAdapter.js.map

package/dist/orchestrator/adapters/publishing/ISocialMediaAdapter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ISocialMediaAdapter.js","sourceRoot":"","sources":["../../../../orchestrator/adapters/publishing/ISocialMediaAdapter.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG"}

package/dist/orchestrator/adapters/publishing/instagram.adapter.d.ts

@@ -0,0 +1,34 @@
+/**
+ * InstagramAdapter — Stub
+ *
+ * Adapter for Instagram publishing via the Instagram Graph API.
+ *
+ * CRITICAL SAFETY NOTE:
+ * Publishing to Instagram is a real, irreversible action.
+ * This adapter MUST only be called after explicit human approval
+ * has been recorded via the ApprovalGate.
+ *
+ * STATUS: STUB — all methods log and return mock data.
+ * To activate: set INSTAGRAM_ACCESS_TOKEN and INSTAGRAM_ACCOUNT_ID.
+ */
+import type { ISocialMediaAdapter, PostDraft, PublishedPost, PostAnalytics, AccountInfo, PublishingCapabilities } from './ISocialMediaAdapter.js';
+export declare class InstagramAdapter implements ISocialMediaAdapter {
+    readonly id = "instagram";
+    readonly platform = "Instagram";
+    private accessToken;
+    private accountId;
+    constructor(opts?: {
+        accessToken?: string;
+        accountId?: string;
+    });
+    initialize(): Promise<void>;
+    getAccountInfo(): Promise<AccountInfo>;
+    publishPost(draft: PostDraft): Promise<PublishedPost>;
+    schedulePost(draft: PostDraft, publishAt: string): Promise<PublishedPost>;
+    getPostAnalytics(postId: string): Promise<PostAnalytics>;
+    listPosts(_limit?: number): Promise<PublishedPost[]>;
+    cancelScheduledPost(postId: string): Promise<void>;
+    getCapabilities(): PublishingCapabilities;
+    healthCheck(): Promise<boolean>;
+}
+//# sourceMappingURL=instagram.adapter.d.ts.map

package/dist/orchestrator/adapters/publishing/instagram.adapter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"instagram.adapter.d.ts","sourceRoot":"","sources":["../../../../orchestrator/adapters/publishing/instagram.adapter.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAEH,OAAO,KAAK,EAAE,mBAAmB,EAAE,SAAS,EAAE,aAAa,EAAE,aAAa,EAAE,WAAW,EAAE,sBAAsB,EAAE,MAAM,0BAA0B,CAAA;AAEjJ,qBAAa,gBAAiB,YAAW,mBAAmB;IAC1D,QAAQ,CAAC,EAAE,eAAc;IACzB,QAAQ,CAAC,QAAQ,eAAc;IAE/B,OAAO,CAAC,WAAW,CAAoB;IACvC,OAAO,CAAC,SAAS,CAAoB;gBAEzB,IAAI,CAAC,EAAE;QAAE,WAAW,CAAC,EAAE,MAAM,CAAC;QAAC,SAAS,CAAC,EAAE,MAAM,CAAA;KAAE;IAKzD,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC;IAM3B,cAAc,IAAI,OAAO,CAAC,WAAW,CAAC;IAatC,WAAW,CAAC,KAAK,EAAE,SAAS,GAAG,OAAO,CAAC,aAAa,CAAC;IAgBrD,YAAY,CAAC,KAAK,EAAE,SAAS,EAAE,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,aAAa,CAAC;IAczE,gBAAgB,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,aAAa,CAAC;IAexD,SAAS,CAAC,MAAM,SAAK,GAAG,OAAO,CAAC,aAAa,EAAE,CAAC;IAIhD,mBAAmB,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAIxD,eAAe,IAAI,sBAAsB;IAYnC,WAAW,IAAI,OAAO,CAAC,OAAO,CAAC;CAItC"}

package/dist/orchestrator/adapters/publishing/instagram.adapter.js

@@ -0,0 +1,105 @@
+/**
+ * InstagramAdapter — Stub
+ *
+ * Adapter for Instagram publishing via the Instagram Graph API.
+ *
+ * CRITICAL SAFETY NOTE:
+ * Publishing to Instagram is a real, irreversible action.
+ * This adapter MUST only be called after explicit human approval
+ * has been recorded via the ApprovalGate.
+ *
+ * STATUS: STUB — all methods log and return mock data.
+ * To activate: set INSTAGRAM_ACCESS_TOKEN and INSTAGRAM_ACCOUNT_ID.
+ */
+export class InstagramAdapter {
+    id = 'instagram';
+    platform = 'Instagram';
+    accessToken;
+    accountId;
+    constructor(opts) {
+        this.accessToken = opts?.accessToken ?? process.env['INSTAGRAM_ACCESS_TOKEN'];
+        this.accountId = opts?.accountId ?? process.env['INSTAGRAM_ACCOUNT_ID'];
+    }
+    async initialize() {
+        if (!this.accessToken || !this.accountId) {
+            console.warn('[InstagramAdapter] INSTAGRAM_ACCESS_TOKEN or INSTAGRAM_ACCOUNT_ID not set — running in stub mode');
+        }
+    }
+    async getAccountInfo() {
+        // STUB: GET /{account-id}?fields=id,username,name,followers_count
+        return {
+            id: this.accountId ?? 'stub-account-id',
+            username: 'stub_account',
+            displayName: 'Stub Account',
+            platform: 'Instagram',
+            followerCount: 0,
+            followingCount: 0,
+            postCount: 0,
+        };
+    }
+    async publishPost(draft) {
+        // SAFETY: This method must only be called after ApprovalGate confirms human approval.
+        // STUB: POST /{account-id}/media + /{account-id}/media_publish
+        console.log(`[InstagramAdapter][STUB] publishPost: ${draft.caption.slice(0, 60)}...`);
+        console.warn('[InstagramAdapter][STUB] Real publishing NOT executed — stub mode active');
+        return {
+            id: `stub-post-${Date.now()}`,
+            platformPostId: 'stub-platform-id',
+            url: 'https://www.instagram.com/p/stub/',
+            caption: draft.caption,
+            publishedAt: new Date().toISOString(),
+            status: 'pending_review',
+            platform: 'Instagram',
+        };
+    }
+    async schedulePost(draft, publishAt) {
+        // STUB: Requires Content Publishing API with scheduling support
+        console.log(`[InstagramAdapter][STUB] schedulePost for ${publishAt}: ${draft.caption.slice(0, 60)}`);
+        return {
+            id: `stub-scheduled-${Date.now()}`,
+            platformPostId: 'stub-scheduled-platform-id',
+            url: 'https://www.instagram.com/p/stub/',
+            caption: draft.caption,
+            publishedAt: publishAt,
+            status: 'scheduled',
+            platform: 'Instagram',
+        };
+    }
+    async getPostAnalytics(postId) {
+        // STUB: GET /{media-id}/insights
+        return {
+            postId,
+            impressions: 0,
+            reach: 0,
+            engagement: 0,
+            likes: 0,
+            comments: 0,
+            shares: 0,
+            saves: 0,
+            measuredAt: new Date().toISOString(),
+        };
+    }
+    async listPosts(_limit = 10) {
+        return [];
+    }
+    async cancelScheduledPost(postId) {
+        console.log(`[InstagramAdapter][STUB] cancelScheduledPost: ${postId}`);
+    }
+    getCapabilities() {
+        return {
+            supportsScheduling: true,
+            supportsCarousel: true,
+            supportsVideo: true,
+            supportsStories: true,
+            supportsAnalytics: true,
+            maxCaptionLength: 2200,
+            maxHashtags: 30,
+        };
+    }
+    async healthCheck() {
+        if (!this.accessToken)
+            return false;
+        return true;
+    }
+}
+//# sourceMappingURL=instagram.adapter.js.map

package/dist/orchestrator/adapters/publishing/instagram.adapter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"instagram.adapter.js","sourceRoot":"","sources":["../../../../orchestrator/adapters/publishing/instagram.adapter.ts"],"names":[],"mappings":"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"}

package/dist/orchestrator/adapters/tools/IToolAdapter.d.ts

@@ -0,0 +1,52 @@
+/**
+ * IToolAdapter — Tool/Integration Adapter Interface
+ *
+ * Abstracts external tool invocations (web search, code execution,
+ * file operations, API calls, MCP tools, etc.).
+ *
+ * STATUS: Interface defined. Concrete adapters are domain-specific stubs.
+ */
+export interface ToolInput {
+    name: string;
+    arguments: Record<string, unknown>;
+}
+export interface ToolOutput {
+    name: string;
+    result: unknown;
+    error?: string;
+    metadata?: Record<string, unknown>;
+}
+export interface AvailableTool {
+    id: string;
+    name: string;
+    description: string;
+    inputSchema: Record<string, unknown>;
+    category: ToolCategory;
+}
+export type ToolCategory = 'filesystem' | 'web' | 'code' | 'git' | 'api' | 'media' | 'database' | 'mcp' | 'custom';
+/**
+ * Generic tool adapter interface.
+ * Each integration (filesystem, GitHub, web search, etc.) implements this.
+ */
+export interface IToolAdapter {
+    readonly id: string;
+    readonly name: string;
+    readonly category: ToolCategory;
+    /**
+     * List tools provided by this adapter.
+     */
+    listTools(): AvailableTool[];
+    /**
+     * Execute a tool call.
+     */
+    invoke(input: ToolInput): Promise<ToolOutput>;
+    /**
+     * Check if a specific tool is supported.
+     */
+    supports(toolName: string): boolean;
+    /**
+     * Health check — verify the integration is operational.
+     */
+    healthCheck(): Promise<boolean>;
+}
+//# sourceMappingURL=IToolAdapter.d.ts.map

package/dist/orchestrator/adapters/tools/IToolAdapter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"IToolAdapter.d.ts","sourceRoot":"","sources":["../../../../orchestrator/adapters/tools/IToolAdapter.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,MAAM,WAAW,SAAS;IACxB,IAAI,EAAE,MAAM,CAAA;IACZ,SAAS,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;CACnC;AAED,MAAM,WAAW,UAAU;IACzB,IAAI,EAAE,MAAM,CAAA;IACZ,MAAM,EAAE,OAAO,CAAA;IACf,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;CACnC;AAED,MAAM,WAAW,aAAa;IAC5B,EAAE,EAAE,MAAM,CAAA;IACV,IAAI,EAAE,MAAM,CAAA;IACZ,WAAW,EAAE,MAAM,CAAA;IACnB,WAAW,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;IACpC,QAAQ,EAAE,YAAY,CAAA;CACvB;AAED,MAAM,MAAM,YAAY,GACpB,YAAY,GACZ,KAAK,GACL,MAAM,GACN,KAAK,GACL,KAAK,GACL,OAAO,GACP,UAAU,GACV,KAAK,GACL,QAAQ,CAAA;AAEZ;;;GAGG;AACH,MAAM,WAAW,YAAY;IAC3B,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAA;IACnB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;IACrB,QAAQ,CAAC,QAAQ,EAAE,YAAY,CAAA;IAE/B;;OAEG;IACH,SAAS,IAAI,aAAa,EAAE,CAAA;IAE5B;;OAEG;IACH,MAAM,CAAC,KAAK,EAAE,SAAS,GAAG,OAAO,CAAC,UAAU,CAAC,CAAA;IAE7C;;OAEG;IACH,QAAQ,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAA;IAEnC;;OAEG;IACH,WAAW,IAAI,OAAO,CAAC,OAAO,CAAC,CAAA;CAChC"}

package/dist/orchestrator/adapters/tools/IToolAdapter.js

@@ -0,0 +1,10 @@
+/**
+ * IToolAdapter — Tool/Integration Adapter Interface
+ *
+ * Abstracts external tool invocations (web search, code execution,
+ * file operations, API calls, MCP tools, etc.).
+ *
+ * STATUS: Interface defined. Concrete adapters are domain-specific stubs.
+ */
+export {};
+//# sourceMappingURL=IToolAdapter.js.map

package/dist/orchestrator/adapters/tools/IToolAdapter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"IToolAdapter.js","sourceRoot":"","sources":["../../../../orchestrator/adapters/tools/IToolAdapter.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG"}

package/dist/orchestrator/adapters/vcs/IVCSAdapter.d.ts

@@ -0,0 +1,89 @@
+/**
+ * IVCSAdapter — Version Control System Adapter Interface
+ *
+ * Abstracts VCS operations (git, GitHub, GitLab, Bitbucket, etc.).
+ * The core orchestrator only interacts with this interface — never with
+ * specific VCS clients or APIs.
+ *
+ * STATUS: Interface defined. Concrete adapters: github (stub)
+ */
+export interface BranchOptions {
+    baseBranch?: string;
+    checkout?: boolean;
+}
+export interface CommitOptions {
+    message: string;
+    /** Files to stage. If empty, stages all changes */
+    files?: string[];
+    allowEmpty?: boolean;
+}
+export interface PullRequestOptions {
+    title: string;
+    body: string;
+    baseBranch: string;
+    headBranch: string;
+    draft?: boolean;
+    labels?: string[];
+    reviewers?: string[];
+}
+export interface PullRequestInfo {
+    id: string;
+    number: number;
+    url: string;
+    title: string;
+    status: 'open' | 'closed' | 'merged' | 'draft';
+    baseBranch: string;
+    headBranch: string;
+    createdAt: string;
+}
+export interface CommitInfo {
+    sha: string;
+    message: string;
+    author: string;
+    timestamp: string;
+    url?: string;
+}
+export interface BranchInfo {
+    name: string;
+    sha: string;
+    isDefault: boolean;
+    isProtected: boolean;
+}
+export interface VCSCapabilities {
+    supportsPullRequests: boolean;
+    supportsReviews: boolean;
+    supportsLabels: boolean;
+    supportsWebhooks: boolean;
+}
+/**
+ * Interface for VCS (version control) adapters.
+ * Implement this to add GitHub, GitLab, Bitbucket, or bare git support.
+ */
+export interface IVCSAdapter {
+    readonly id: string;
+    readonly name: string;
+    initialize(): Promise<void>;
+    /** Get current branch name */
+    getCurrentBranch(): Promise<string>;
+    /** List all branches */
+    listBranches(): Promise<BranchInfo[]>;
+    /** Create and optionally checkout a new branch */
+    createBranch(name: string, options?: BranchOptions): Promise<BranchInfo>;
+    /** Stage and commit files */
+    commit(options: CommitOptions): Promise<CommitInfo>;
+    /** Push branch to remote */
+    push(branch: string, force?: boolean): Promise<void>;
+    /** Create a pull request / merge request */
+    createPullRequest(options: PullRequestOptions): Promise<PullRequestInfo>;
+    /** Get pull request info by number */
+    getPullRequest(number: number): Promise<PullRequestInfo>;
+    /** List open pull requests */
+    listPullRequests(state?: 'open' | 'closed' | 'all'): Promise<PullRequestInfo[]>;
+    /** Add a comment to a pull request */
+    commentOnPullRequest(number: number, body: string): Promise<void>;
+    /** Get recent commit history */
+    getCommitHistory(branch?: string, limit?: number): Promise<CommitInfo[]>;
+    getCapabilities(): VCSCapabilities;
+    healthCheck(): Promise<boolean>;
+}
+//# sourceMappingURL=IVCSAdapter.d.ts.map

package/dist/orchestrator/adapters/vcs/IVCSAdapter.d.ts.map

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

package/dist/orchestrator/adapters/vcs/IVCSAdapter.js

@@ -0,0 +1,11 @@
+/**
+ * IVCSAdapter — Version Control System Adapter Interface
+ *
+ * Abstracts VCS operations (git, GitHub, GitLab, Bitbucket, etc.).
+ * The core orchestrator only interacts with this interface — never with
+ * specific VCS clients or APIs.
+ *
+ * STATUS: Interface defined. Concrete adapters: github (stub)
+ */
+export {};
+//# sourceMappingURL=IVCSAdapter.js.map

package/dist/orchestrator/adapters/vcs/IVCSAdapter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"IVCSAdapter.js","sourceRoot":"","sources":["../../../../orchestrator/adapters/vcs/IVCSAdapter.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG"}

package/dist/orchestrator/adapters/vcs/github.adapter.d.ts

@@ -0,0 +1,36 @@
+/**
+ * GitHubVCSAdapter — Stub
+ *
+ * Adapter for GitHub operations: branches, commits, PRs, comments.
+ * Uses the GitHub REST API (via GITHUB_TOKEN).
+ *
+ * STATUS: STUB — all methods log and return mock data.
+ * To activate: set GITHUB_TOKEN and GITHUB_REPO, then implement API calls.
+ */
+import type { IVCSAdapter, BranchOptions, CommitOptions, PullRequestOptions, PullRequestInfo, CommitInfo, BranchInfo, VCSCapabilities } from './IVCSAdapter.js';
+export declare class GitHubVCSAdapter implements IVCSAdapter {
+    readonly id = "github";
+    readonly name = "GitHub";
+    private token;
+    private repo;
+    private owner;
+    constructor(opts?: {
+        token?: string;
+        owner?: string;
+        repo?: string;
+    });
+    initialize(): Promise<void>;
+    getCurrentBranch(): Promise<string>;
+    listBranches(): Promise<BranchInfo[]>;
+    createBranch(name: string, _options?: BranchOptions): Promise<BranchInfo>;
+    commit(options: CommitOptions): Promise<CommitInfo>;
+    push(branch: string, _force?: boolean): Promise<void>;
+    createPullRequest(options: PullRequestOptions): Promise<PullRequestInfo>;
+    getPullRequest(number: number): Promise<PullRequestInfo>;
+    listPullRequests(_state?: 'open' | 'closed' | 'all'): Promise<PullRequestInfo[]>;
+    commentOnPullRequest(number: number, body: string): Promise<void>;
+    getCommitHistory(_branch?: string, limit?: number): Promise<CommitInfo[]>;
+    getCapabilities(): VCSCapabilities;
+    healthCheck(): Promise<boolean>;
+}
+//# sourceMappingURL=github.adapter.d.ts.map

package/dist/orchestrator/adapters/vcs/github.adapter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"github.adapter.d.ts","sourceRoot":"","sources":["../../../../orchestrator/adapters/vcs/github.adapter.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,KAAK,EAAE,WAAW,EAAE,aAAa,EAAE,aAAa,EAAE,kBAAkB,EAAE,eAAe,EAAE,UAAU,EAAE,UAAU,EAAE,eAAe,EAAE,MAAM,kBAAkB,CAAA;AAE/J,qBAAa,gBAAiB,YAAW,WAAW;IAClD,QAAQ,CAAC,EAAE,YAAW;IACtB,QAAQ,CAAC,IAAI,YAAW;IAExB,OAAO,CAAC,KAAK,CAAoB;IACjC,OAAO,CAAC,IAAI,CAAoB;IAChC,OAAO,CAAC,KAAK,CAAoB;gBAErB,IAAI,CAAC,EAAE;QAAE,KAAK,CAAC,EAAE,MAAM,CAAC;QAAC,KAAK,CAAC,EAAE,MAAM,CAAC;QAAC,IAAI,CAAC,EAAE,MAAM,CAAA;KAAE;IAQ9D,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC;IAM3B,gBAAgB,IAAI,OAAO,CAAC,MAAM,CAAC;IAKnC,YAAY,IAAI,OAAO,CAAC,UAAU,EAAE,CAAC;IAKrC,YAAY,CAAC,IAAI,EAAE,MAAM,EAAE,QAAQ,CAAC,EAAE,aAAa,GAAG,OAAO,CAAC,UAAU,CAAC;IAMzE,MAAM,CAAC,OAAO,EAAE,aAAa,GAAG,OAAO,CAAC,UAAU,CAAC;IAWnD,IAAI,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,UAAQ,GAAG,OAAO,CAAC,IAAI,CAAC;IAInD,iBAAiB,CAAC,OAAO,EAAE,kBAAkB,GAAG,OAAO,CAAC,eAAe,CAAC;IAexE,cAAc,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,eAAe,CAAC;IAcxD,gBAAgB,CAAC,MAAM,GAAE,MAAM,GAAG,QAAQ,GAAG,KAAc,GAAG,OAAO,CAAC,eAAe,EAAE,CAAC;IAIxF,oBAAoB,CAAC,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAIjE,gBAAgB,CAAC,OAAO,CAAC,EAAE,MAAM,EAAE,KAAK,SAAK,GAAG,OAAO,CAAC,UAAU,EAAE,CAAC;IAS3E,eAAe,IAAI,eAAe;IAS5B,WAAW,IAAI,OAAO,CAAC,OAAO,CAAC;CAKtC"}

package/dist/orchestrator/adapters/vcs/github.adapter.js

@@ -0,0 +1,110 @@
+/**
+ * GitHubVCSAdapter — Stub
+ *
+ * Adapter for GitHub operations: branches, commits, PRs, comments.
+ * Uses the GitHub REST API (via GITHUB_TOKEN).
+ *
+ * STATUS: STUB — all methods log and return mock data.
+ * To activate: set GITHUB_TOKEN and GITHUB_REPO, then implement API calls.
+ */
+export class GitHubVCSAdapter {
+    id = 'github';
+    name = 'GitHub';
+    token;
+    repo;
+    owner;
+    constructor(opts) {
+        this.token = opts?.token ?? process.env['GITHUB_TOKEN'];
+        const fullRepo = opts?.repo ?? process.env['GITHUB_REPO'] ?? '';
+        const [owner, repo] = fullRepo.split('/');
+        this.owner = opts?.owner ?? owner;
+        this.repo = repo;
+    }
+    async initialize() {
+        if (!this.token) {
+            console.warn('[GitHubVCSAdapter] GITHUB_TOKEN not set — running in stub mode');
+        }
+    }
+    async getCurrentBranch() {
+        // STUB: In real impl, run `git rev-parse --abbrev-ref HEAD`
+        return 'main';
+    }
+    async listBranches() {
+        // STUB: GET /repos/{owner}/{repo}/branches
+        return [{ name: 'main', sha: 'abc123', isDefault: true, isProtected: true }];
+    }
+    async createBranch(name, _options) {
+        // STUB: POST /repos/{owner}/{repo}/git/refs
+        console.log(`[GitHubVCSAdapter][STUB] createBranch: ${name}`);
+        return { name, sha: 'stub-sha', isDefault: false, isProtected: false };
+    }
+    async commit(options) {
+        // STUB: In real impl, git add + git commit
+        console.log(`[GitHubVCSAdapter][STUB] commit: ${options.message}`);
+        return {
+            sha: `stub-${Date.now()}`,
+            message: options.message,
+            author: 'squad-foundry[bot]',
+            timestamp: new Date().toISOString(),
+        };
+    }
+    async push(branch, _force = false) {
+        console.log(`[GitHubVCSAdapter][STUB] push: ${branch}`);
+    }
+    async createPullRequest(options) {
+        // STUB: POST /repos/{owner}/{repo}/pulls
+        console.log(`[GitHubVCSAdapter][STUB] createPullRequest: ${options.title}`);
+        return {
+            id: `stub-pr-${Date.now()}`,
+            number: 1,
+            url: `https://github.com/${this.owner}/${this.repo}/pull/1`,
+            title: options.title,
+            status: 'open',
+            baseBranch: options.baseBranch,
+            headBranch: options.headBranch,
+            createdAt: new Date().toISOString(),
+        };
+    }
+    async getPullRequest(number) {
+        // STUB: GET /repos/{owner}/{repo}/pulls/{number}
+        return {
+            id: `stub-pr-${number}`,
+            number,
+            url: `https://github.com/${this.owner}/${this.repo}/pull/${number}`,
+            title: 'Stub PR',
+            status: 'open',
+            baseBranch: 'main',
+            headBranch: 'feature/stub',
+            createdAt: new Date().toISOString(),
+        };
+    }
+    async listPullRequests(_state = 'open') {
+        return [];
+    }
+    async commentOnPullRequest(number, body) {
+        console.log(`[GitHubVCSAdapter][STUB] commentOnPullRequest #${number}: ${body.slice(0, 80)}`);
+    }
+    async getCommitHistory(_branch, limit = 10) {
+        return Array.from({ length: Math.min(limit, 3) }, (_, i) => ({
+            sha: `stub-sha-${i}`,
+            message: `Stub commit ${i}`,
+            author: 'squad-foundry[bot]',
+            timestamp: new Date().toISOString(),
+        }));
+    }
+    getCapabilities() {
+        return {
+            supportsPullRequests: true,
+            supportsReviews: true,
+            supportsLabels: true,
+            supportsWebhooks: true,
+        };
+    }
+    async healthCheck() {
+        if (!this.token)
+            return false;
+        // STUB: GET /user
+        return true;
+    }
+}
+//# sourceMappingURL=github.adapter.js.map

package/dist/orchestrator/adapters/vcs/github.adapter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"github.adapter.js","sourceRoot":"","sources":["../../../../orchestrator/adapters/vcs/github.adapter.ts"],"names":[],"mappings":"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"}

package/dist/orchestrator/artifacts/artifact-store.d.ts

@@ -0,0 +1,47 @@
+/**
+ * ArtifactStore
+ *
+ * Filesystem-based artifact persistence for squad jobs.
+ * All job state, handoffs, events, outputs, and approvals are stored
+ * as human-readable JSON/Markdown files under:
+ *
+ *   artifacts/<squad_id>/<job_id>/
+ *     state.json
+ *     handoffs.json
+ *     events.json
+ *     approvals.json
+ *     outputs/
+ *     reports/
+ */
+import type { JobDefinition, HandoffEvent, HistoryEntry, ApprovalRecord, ArtifactRef, PendingArtifact, JobId, SquadId, AgentId, StepId } from '../core/types.js';
+export declare class ArtifactStore {
+    private baseDir;
+    constructor(baseDir?: string);
+    private jobDir;
+    private ensureDir;
+    private write;
+    private read;
+    /** Persist the full job state */
+    saveJob(job: JobDefinition): void;
+    /** Load a job state from disk */
+    loadJob(squadId: SquadId, jobId: JobId): JobDefinition | null;
+    /** List all job IDs for a squad */
+    listJobs(squadId: SquadId): JobId[];
+    appendHandoff(squadId: SquadId, jobId: JobId, handoff: HandoffEvent): void;
+    loadHandoffs(squadId: SquadId, jobId: JobId): HandoffEvent[];
+    appendEvent(squadId: SquadId, jobId: JobId, event: HistoryEntry): void;
+    loadEvents(squadId: SquadId, jobId: JobId): HistoryEntry[];
+    saveApprovals(squadId: SquadId, jobId: JobId, approvals: ApprovalRecord[]): void;
+    loadApprovals(squadId: SquadId, jobId: JobId): ApprovalRecord[];
+    /**
+     * Persist a pending artifact (content produced by an agent) to disk.
+     * Returns an ArtifactRef that can be stored in the job.
+     */
+    persistArtifact(squadId: SquadId, jobId: JobId, artifact: PendingArtifact, agentId: AgentId, stepId: StepId): ArtifactRef;
+    /** Save a Markdown report to artifacts/<squad_id>/<job_id>/reports/ */
+    saveReport(squadId: SquadId, jobId: JobId, name: string, content: string): string;
+    /** List all artifact refs from the job's outputs directory */
+    listArtifacts(squadId: SquadId, jobId: JobId): string[];
+}
+export declare function createArtifactStore(baseDir?: string): ArtifactStore;
+//# sourceMappingURL=artifact-store.d.ts.map

package/dist/orchestrator/artifacts/artifact-store.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"artifact-store.d.ts","sourceRoot":"","sources":["../../../orchestrator/artifacts/artifact-store.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAKH,OAAO,KAAK,EACV,aAAa,EACb,YAAY,EACZ,YAAY,EACZ,cAAc,EACd,WAAW,EACX,eAAe,EACf,KAAK,EACL,OAAO,EACP,OAAO,EACP,MAAM,EACP,MAAM,kBAAkB,CAAA;AAMzB,qBAAa,aAAa;IACxB,OAAO,CAAC,OAAO,CAAQ;gBAEX,OAAO,SAAc;IAIjC,OAAO,CAAC,MAAM;IAId,OAAO,CAAC,SAAS;IAIjB,OAAO,CAAC,KAAK;IAKb,OAAO,CAAC,IAAI;IAWZ,iCAAiC;IACjC,OAAO,CAAC,GAAG,EAAE,aAAa,GAAG,IAAI;IAKjC,iCAAiC;IACjC,OAAO,CAAC,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,KAAK,GAAG,aAAa,GAAG,IAAI;IAI7D,mCAAmC;IACnC,QAAQ,CAAC,OAAO,EAAE,OAAO,GAAG,KAAK,EAAE;IAUnC,aAAa,CAAC,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,KAAK,EAAE,OAAO,EAAE,YAAY,GAAG,IAAI;IAO1E,YAAY,CAAC,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,KAAK,GAAG,YAAY,EAAE;IAM5D,WAAW,CAAC,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE,YAAY,GAAG,IAAI;IAOtE,UAAU,CAAC,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,KAAK,GAAG,YAAY,EAAE;IAM1D,aAAa,CAAC,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,KAAK,EAAE,SAAS,EAAE,cAAc,EAAE,GAAG,IAAI;IAKhF,aAAa,CAAC,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,KAAK,GAAG,cAAc,EAAE;IAM/D;;;OAGG;IACH,eAAe,CACb,OAAO,EAAE,OAAO,EAChB,KAAK,EAAE,KAAK,EACZ,QAAQ,EAAE,eAAe,EACzB,OAAO,EAAE,OAAO,EAChB,MAAM,EAAE,MAAM,GACb,WAAW;IAsBd,uEAAuE;IACvE,UAAU,CAAC,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,KAAK,EAAE,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,MAAM;IAQjF,8DAA8D;IAC9D,aAAa,CAAC,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,KAAK,GAAG,MAAM,EAAE;CAKxD;AAED,wBAAgB,mBAAmB,CAAC,OAAO,CAAC,EAAE,MAAM,GAAG,aAAa,CAEnE"}