@mwturnbull/papi-mcp 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 m-w-turnbull
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,320 @@
+# papi-mcp
+
+MCP server for Akamai Property Manager (PAPI) configurations. Gives AI assistants structured access to read, validate, modify, and activate Akamai CDN properties.
+
+## Features
+
+- **14 tools** across read, validate, write, activate, and pipeline workflows
+- **Config-driven redaction** — no hardcoded secrets
+- **GitLab + GitHub** — pluggable git provider with auto-detection
+- **Activation safety** — staging/production split with explicit risk acknowledgement
+- **7 local validation checks** + optional PAPI API validation
+- **LLM-optimized parsing** — flat, breadcrumb-based rule tree representation
+- **Snippet-based configs** — large rule trees split with #include: directives
+
+## Quick Start
+
+### Installation
+
+```bash
+npm install
+npm run build
+```
+
+### Claude Code
+
+Add to your MCP settings (`.cursor/claude_config.json` or Claude settings):
+
+```json
+{
+  "mcpServers": {
+    "papi-mcp": {
+      "command": "node",
+      "args": ["path/to/papi-mcp/dist/server.js"]
+    }
+  }
+}
+```
+
+### VS Code Copilot Chat
+
+Add the same MCP configuration to your VS Code settings.
+
+### Claude Desktop
+
+Add to `~/Library/Application Support/Claude/claude_desktop_config.json`:
+
+```json
+{
+  "mcpServers": {
+    "papi-mcp": {
+      "command": "node",
+      "args": ["path/to/papi-mcp/dist/server.js"]
+    }
+  }
+}
+```
+
+## Tools
+
+### Read & Analyse (5 tools)
+
+| Tool | Description |
+|------|-------------|
+| `get_property_config` | Fetch current property rule tree via PAPI API. Requires `propertyId` or auto-detects from `envInfo.json` in repo. |
+| `read_snippets` | Read local config snippet files or list all snippets. Snippets live in `config-snippets/` directory. |
+| `parse_rule_tree` | Parse PAPI JSON into LLM-optimised flat representation. Accepts either `repoPath` (assembles from disk) or raw `ruleTree` JSON. |
+| `assemble_rule_tree` | Resolve all #include: directives into a complete rule tree. Validates that all includes exist. |
+| `sync_property` | Compare local config against live PAPI version using version-number comparison. |
+
+### Validate & Diff (2 tools)
+
+| Tool | Description |
+|------|-------------|
+| `validate_config` | Run 7 validation checks: JSON syntax, required fields, include resolution, orphan detection, variable references, duplicate names, no-op rules. Optional `apiValidation: true` for PAPI schema compliance. |
+| `diff_configs` | Structured diff between two rule tree versions. Shows behavior-level and criteria-level changes. |
+
+### Write & Ship (4 tools)
+
+| Tool | Description |
+|------|-------------|
+| `write_snippet` | Create or update a config snippet file. Validates against PapiRule schema. |
+| `apply_behavior` | Add or modify a single behavior in an existing snippet. Useful for targeted changes. |
+| `create_branch` | Create git branch following `akamai/<type>/<description>` naming convention. Types: feature, fix, refactor, chore. |
+| `create_merge_request` | Commit changes, push branch, and open a GitLab MR or GitHub PR. Auto-detects git provider. |
+
+### Activate & Pipeline (3 tools)
+
+| Tool | Description |
+|------|-------------|
+| `activate_staging` | Activate property version to Akamai staging network. Returns immediately; check status via polling. |
+| `activate_production` | Activate to production. Requires `acknowledgeProductionRisk: true` and at least one `contactEmails` entry. |
+| `trigger_pipeline` | Trigger CI/CD pipeline for current branch. Useful for automated testing. |
+
+## Configuration
+
+### Akamai Credentials
+
+Option 1: `.edgerc` file (default location: `~/.edgerc`):
+
+```ini
+[default]
+client_secret = xxxx
+host = xxxx.luna.akamaiapis.net
+access_token = xxxx
+client_token = xxxx
+```
+
+Option 2: Environment variables:
+
+```bash
+export AKAMAI_CLIENT_SECRET=xxxx
+export AKAMAI_HOST=xxxx.luna.akamaiapis.net
+export AKAMAI_ACCESS_TOKEN=xxxx
+export AKAMAI_CLIENT_TOKEN=xxxx
+```
+
+Get credentials from Akamai Control Center or ask your team administrator.
+
+### Redaction Config (.papi-mcp.json)
+
+Create `.papi-mcp.json` in your project root to configure sensitive field redaction:
+
+```json
+{
+  "redact": {
+    "sensitiveVariables": true,
+    "fields": ["options.hostname", "options.headerValue"],
+    "sensitiveHeaders": ["authorization", "x-api-key"]
+  },
+  "gitProvider": {
+    "type": "gitlab",
+    "host": "gitlab.internal.example.com"
+  }
+}
+```
+
+Redaction prevents secrets from appearing in logs and AI outputs.
+
+### Git Provider
+
+Auto-detected from git remote URL. Override in `.papi-mcp.json` for custom domains.
+
+**GitLab:**
+
+Set one of: `GITLAB_TOKEN`, `GITLAB_PERSONAL_ACCESS_TOKEN`, or `CI_JOB_TOKEN`
+
+```bash
+export GITLAB_TOKEN=glpat-xxxx
+```
+
+**GitHub:**
+
+Set one of: `GITHUB_TOKEN` or `GH_TOKEN`
+
+```bash
+export GITHUB_TOKEN=ghp_xxxx
+```
+
+### Property Metadata (envInfo.json)
+
+Auto-detected from property repo structure. Place in `{propertyName}/envInfo.json`:
+
+```json
+{
+  "name": "my-property",
+  "propertyId": 12345,
+  "propertyName": "my-property",
+  "groupId": 67890,
+  "isSecure": false,
+  "latestVersionInfo": {
+    "propertyVersion": 5,
+    "productionStatus": "ACTIVE",
+    "stagingStatus": "ACTIVE",
+    "ruleFormat": "v2024-02-12"
+  }
+}
+```
+
+## Recommended Workflow
+
+1. **Understand current state**: `read_snippets` → `parse_rule_tree`
+2. **Create branch**: `create_branch` with type and description
+3. **Make changes**: `write_snippet` or `apply_behavior`
+4. **Validate**: `validate_config` to check for issues
+5. **Review changes**: `diff_configs` to compare
+6. **Open for review**: `create_merge_request` to create MR/PR
+7. **After approval, activate**:
+   - `activate_staging` to test on staging
+   - `activate_production` to go live
+
+## Architecture
+
+```
+src/
+├── server.ts                    # MCP server entry (14 tool registrations)
+├── papi/
+│   ├── types.ts                # Zod schemas and TypeScript types
+│   ├── auth.ts                 # EdgeGrid credential resolution
+│   └── client.ts               # PAPI HTTP client
+├── config/
+│   ├── snippets.ts             # Snippet file I/O operations
+│   ├── assembler.ts            # #include: directive resolution
+│   └── parser.ts               # LLM-optimized rule tree parser
+├── validation/
+│   ├── local.ts                # 7 local validation checks
+│   └── papi.ts                 # PAPI API validation wrapper
+├── tools/
+│   ├── get-property-config.ts  # Fetch property from PAPI
+│   ├── read-snippets.ts        # Read local config files
+│   ├── diff-configs.ts         # Structured config diffing
+│   ├── sync-property.ts        # Local vs live comparison
+│   ├── write-snippet.ts        # Create/update config files
+│   ├── activate.ts             # Staging/production activation
+│   └── pipeline.ts             # CI/CD pipeline triggering
+├── git/
+│   ├── git-ops.ts              # Core git operations
+│   ├── provider.ts             # GitProvider interface + factory
+│   ├── gitlab.ts               # GitLab API client
+│   └── github.ts               # GitHub API client
+├── redaction/
+│   └── redactor.ts             # Config-driven field redaction
+└── skill/
+    └── system-prompt.md        # AI domain knowledge layer
+```
+
+## Development
+
+```bash
+npm install              # Install dependencies
+npm run build            # TypeScript compilation
+npm test                 # Run all tests
+npm run test:watch       # Watch mode
+npm run test:coverage    # Coverage report
+npm run dev              # Dev mode with tsx
+npm run lint             # Type checking
+```
+
+## Testing
+
+Run the full test suite:
+
+```bash
+npm test
+```
+
+Watch mode for development:
+
+```bash
+npm run test:watch
+```
+
+Coverage report:
+
+```bash
+npm run test:coverage
+```
+
+Test fixtures are in `tests/fixtures/`:
+
+- `sample-property/` — valid property configuration with snippets
+- `api-responses/` — mock PAPI API responses
+- `invalid-configs/` — invalid configs for validation testing
+
+## Best Practices
+
+- Use descriptive snippet names: `CORS_Policy.json`, `API_Caching.json`, `Origins.json`
+- Use variables for environment-specific values (hostnames, API keys)
+- Mark sensitive variables as `hidden: true, sensitive: true`
+- Run validation after every change
+- Review diffs before creating merge requests
+- Always activate staging before production
+- Document rule purposes in rule names
+- Group related rules under descriptive parent rules
+
+## Validation Checks
+
+The `validate_config` tool runs 7 checks:
+
+1. **JSON syntax** — all files must be valid JSON (error)
+2. **Required fields** — name, children, behaviors, criteria, criteriaMustSatisfy (error)
+3. **Include resolution** — all #include: targets must exist (error)
+4. **Orphan detection** — unreferenced snippets (warning)
+5. **Variable references** — PMUSER_ vars must be declared (warning)
+6. **Duplicate rule names** — siblings with same name (warning)
+7. **No-op rules** — empty behaviors + criteria + children (info)
+
+Use `apiValidation: true` to also check PAPI schema compliance.
+
+## Troubleshooting
+
+### Credentials Not Found
+
+Make sure one of:
+
+- `~/.edgerc` exists with [default] section
+- Environment variables are set: `AKAMAI_CLIENT_SECRET`, `AKAMAI_HOST`, `AKAMAI_ACCESS_TOKEN`, `AKAMAI_CLIENT_TOKEN`
+
+### Property Not Found
+
+Verify:
+
+- `propertyId` is correct (e.g., `prp_12345`)
+- `groupId` is correct (auto-detected from `envInfo.json`)
+- Account has access to the property
+
+### Git Provider Not Detected
+
+Make sure:
+
+- Git remote is set: `git remote -v`
+- Git token is set: `GITLAB_TOKEN` or `GITHUB_TOKEN`
+- `.papi-mcp.json` is configured if using custom domain
+
+### Validation Errors
+
+Run `validate_config` with `apiValidation: true` to get PAPI schema validation details.
+
+## License
+
+MIT

package/dist/config/assembler.d.ts

@@ -0,0 +1,6 @@
+import type { RuleTree } from '../papi/types.js';
+export declare class AssemblerError extends Error {
+    constructor(message: string);
+}
+export declare function assembleRuleTree(repoPath: string): Promise<RuleTree>;
+//# sourceMappingURL=assembler.d.ts.map

package/dist/config/assembler.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"assembler.d.ts","sourceRoot":"","sources":["../../src/config/assembler.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAY,QAAQ,EAAE,MAAM,kBAAkB,CAAC;AAE3D,qBAAa,cAAe,SAAQ,KAAK;gBAC3B,OAAO,EAAE,MAAM;CAI5B;AAED,wBAAsB,gBAAgB,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,QAAQ,CAAC,CAkB1E"}

package/dist/config/assembler.js

@@ -0,0 +1,56 @@
+import { readFile } from 'node:fs/promises';
+import { resolve } from 'node:path';
+import { findPmDirectory } from './snippets.js';
+export class AssemblerError extends Error {
+    constructor(message) {
+        super(message);
+        this.name = 'AssemblerError';
+    }
+}
+export async function assembleRuleTree(repoPath) {
+    const pmDir = await findPmDirectory(repoPath);
+    const mainPath = resolve(pmDir, 'config-snippets', 'main.json');
+    const mainContent = await readFile(mainPath, 'utf-8');
+    const mainJson = JSON.parse(mainContent);
+    // main.json has the { rules: { ... } } envelope
+    const rootRule = mainJson.rules;
+    // Resolve #include: directives in children
+    const snippetsDir = resolve(pmDir, 'config-snippets');
+    const resolved = await resolveIncludes(rootRule, snippetsDir, new Set());
+    return {
+        rules: resolved,
+        ruleFormat: undefined, // Will come from envInfo if needed
+    };
+}
+async function resolveIncludes(rule, snippetsDir, visited) {
+    const resolvedChildren = [];
+    for (const child of rule.children) {
+        if (typeof child === 'string' && child.startsWith('#include:')) {
+            const filename = child.slice('#include:'.length);
+            if (visited.has(filename)) {
+                throw new AssemblerError(`Circular include detected: ${filename} (chain: ${[...visited].join(' → ')} → ${filename})`);
+            }
+            const filePath = resolve(snippetsDir, filename);
+            let content;
+            try {
+                content = await readFile(filePath, 'utf-8');
+            }
+            catch {
+                throw new AssemblerError(`Missing include target: ${filename} (expected at ${filePath})`);
+            }
+            const snippet = JSON.parse(content);
+            visited.add(filename);
+            const resolved = await resolveIncludes(snippet, snippetsDir, visited);
+            visited.delete(filename);
+            resolvedChildren.push(resolved);
+        }
+        else if (typeof child === 'object') {
+            resolvedChildren.push(await resolveIncludes(child, snippetsDir, visited));
+        }
+    }
+    return {
+        ...rule,
+        children: resolvedChildren,
+    };
+}
+//# sourceMappingURL=assembler.js.map

package/dist/config/assembler.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"assembler.js","sourceRoot":"","sources":["../../src/config/assembler.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAC;AAC5C,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACpC,OAAO,EAAE,eAAe,EAAE,MAAM,eAAe,CAAC;AAGhD,MAAM,OAAO,cAAe,SAAQ,KAAK;IACvC,YAAY,OAAe;QACzB,KAAK,CAAC,OAAO,CAAC,CAAC;QACf,IAAI,CAAC,IAAI,GAAG,gBAAgB,CAAC;IAC/B,CAAC;CACF;AAED,MAAM,CAAC,KAAK,UAAU,gBAAgB,CAAC,QAAgB;IACrD,MAAM,KAAK,GAAG,MAAM,eAAe,CAAC,QAAQ,CAAC,CAAC;IAC9C,MAAM,QAAQ,GAAG,OAAO,CAAC,KAAK,EAAE,iBAAiB,EAAE,WAAW,CAAC,CAAC;IAEhE,MAAM,WAAW,GAAG,MAAM,QAAQ,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAC;IACtD,MAAM,QAAQ,GAAG,IAAI,CAAC,KAAK,CAAC,WAAW,CAAwB,CAAC;IAEhE,gDAAgD;IAChD,MAAM,QAAQ,GAAG,QAAQ,CAAC,KAAK,CAAC;IAEhC,2CAA2C;IAC3C,MAAM,WAAW,GAAG,OAAO,CAAC,KAAK,EAAE,iBAAiB,CAAC,CAAC;IACtD,MAAM,QAAQ,GAAG,MAAM,eAAe,CAAC,QAAQ,EAAE,WAAW,EAAE,IAAI,GAAG,EAAU,CAAC,CAAC;IAEjF,OAAO;QACL,KAAK,EAAE,QAAQ;QACf,UAAU,EAAE,SAAS,EAAE,mCAAmC;KAC3D,CAAC;AACJ,CAAC;AAED,KAAK,UAAU,eAAe,CAC5B,IAAc,EACd,WAAmB,EACnB,OAAoB;IAEpB,MAAM,gBAAgB,GAAe,EAAE,CAAC;IAExC,KAAK,MAAM,KAAK,IAAI,IAAI,CAAC,QAAQ,EAAE,CAAC;QAClC,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,CAAC,UAAU,CAAC,WAAW,CAAC,EAAE,CAAC;YAC/D,MAAM,QAAQ,GAAG,KAAK,CAAC,KAAK,CAAC,WAAW,CAAC,MAAM,CAAC,CAAC;YAEjD,IAAI,OAAO,CAAC,GAAG,CAAC,QAAQ,CAAC,EAAE,CAAC;gBAC1B,MAAM,IAAI,cAAc,CACtB,8BAA8B,QAAQ,YAAY,CAAC,GAAG,OAAO,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,MAAM,QAAQ,GAAG,CAC5F,CAAC;YACJ,CAAC;YAED,MAAM,QAAQ,GAAG,OAAO,CAAC,WAAW,EAAE,QAAQ,CAAC,CAAC;YAChD,IAAI,OAAe,CAAC;YACpB,IAAI,CAAC;gBACH,OAAO,GAAG,MAAM,QAAQ,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAC;YAC9C,CAAC;YAAC,MAAM,CAAC;gBACP,MAAM,IAAI,cAAc,CACtB,2BAA2B,QAAQ,iBAAiB,QAAQ,GAAG,CAChE,CAAC;YACJ,CAAC;YAED,MAAM,OAAO,GAAG,IAAI,CAAC,KAAK,CAAC,OAAO,CAAa,CAAC;YAChD,OAAO,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC;YACtB,MAAM,QAAQ,GAAG,MAAM,eAAe,CAAC,OAAO,EAAE,WAAW,EAAE,OAAO,CAAC,CAAC;YACtE,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC;YACzB,gBAAgB,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;QAClC,CAAC;aAAM,IAAI,OAAO,KAAK,KAAK,QAAQ,EAAE,CAAC;YACrC,gBAAgB,CAAC,IAAI,CACnB,MAAM,eAAe,CAAC,KAAiB,EAAE,WAAW,EAAE,OAAO,CAAC,CAC/D,CAAC;QACJ,CAAC;IACH,CAAC;IAED,OAAO;QACL,GAAG,IAAI;QACP,QAAQ,EAAE,gBAAgB;KAC3B,CAAC;AACJ,CAAC"}

package/dist/config/parser.d.ts

@@ -0,0 +1,6 @@
+import type { ParsedRuleTree } from '../papi/types.js';
+export declare function parseRuleTree(options: {
+    repoPath?: string;
+    ruleTree?: string;
+}): Promise<ParsedRuleTree>;
+//# sourceMappingURL=parser.d.ts.map

package/dist/config/parser.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"parser.d.ts","sourceRoot":"","sources":["../../src/config/parser.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAwB,cAAc,EAAE,MAAM,kBAAkB,CAAC;AAG7E,wBAAsB,aAAa,CAAC,OAAO,EAAE;IAC3C,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB,GAAG,OAAO,CAAC,cAAc,CAAC,CAuC1B"}

package/dist/config/parser.js

@@ -0,0 +1,79 @@
+import { assembleRuleTree } from './assembler.js';
+export async function parseRuleTree(options) {
+    let rootRule;
+    let ruleFormat;
+    if (options.repoPath) {
+        const tree = await assembleRuleTree(options.repoPath);
+        rootRule = tree.rules;
+        ruleFormat = tree.ruleFormat;
+    }
+    else if (options.ruleTree) {
+        const parsed = JSON.parse(options.ruleTree);
+        // Handle both { rules: {...} } envelope and bare rule
+        rootRule = (parsed['rules'] ?? parsed);
+        ruleFormat = parsed['ruleFormat'];
+    }
+    else {
+        throw new Error('Either repoPath or ruleTree must be provided');
+    }
+    const rules = [];
+    let totalBehaviors = 0;
+    flattenRule(rootRule, '', rules);
+    for (const r of rules) {
+        totalBehaviors += r.behaviors.length;
+    }
+    const variables = (rootRule.variables ?? []).map(v => ({
+        name: v.name,
+        value: v.value,
+        description: v.description,
+        sensitive: v.sensitive,
+    }));
+    return {
+        rules,
+        variables,
+        ruleFormat,
+        totalRules: rules.length,
+        totalBehaviors,
+    };
+}
+function flattenRule(rule, parentPath, result) {
+    const path = parentPath ? `${parentPath} > ${rule.name}` : rule.name;
+    result.push({
+        path,
+        name: rule.name,
+        behaviors: rule.behaviors.map(b => ({
+            name: b.name,
+            keyOptions: summarizeOptions(b.options),
+        })),
+        criteria: rule.criteria.map(c => ({
+            name: c.name,
+            matchType: c.options['matchOperator'] ?? 'IS',
+            values: c.options['value'] ?? c.options['values'] ?? null,
+        })),
+        comments: rule.comments,
+        childCount: rule.children.length,
+    });
+    for (const child of rule.children) {
+        if (typeof child === 'object') {
+            flattenRule(child, path, result);
+        }
+    }
+}
+function summarizeOptions(options) {
+    const summary = {};
+    for (const [key, value] of Object.entries(options)) {
+        if (typeof value === 'object' && value !== null && !Array.isArray(value)) {
+            // For nested objects, just include key fields
+            const nested = value;
+            if ('id' in nested)
+                summary[key] = { id: nested['id'] };
+            else
+                summary[key] = '[object]';
+        }
+        else {
+            summary[key] = value;
+        }
+    }
+    return summary;
+}
+//# sourceMappingURL=parser.js.map

package/dist/config/parser.js.map

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

package/dist/config/snippets.d.ts

@@ -0,0 +1,12 @@
+import type { PapiRule, EnvInfo, ProjectInfo, HostnameEntry } from '../papi/types.js';
+export declare function findPmDirectory(repoPath: string): Promise<string>;
+export declare function listSnippets(repoPath: string): Promise<string[]>;
+export declare function readSnippet(repoPath: string, snippetName: string): Promise<PapiRule>;
+export declare function readAllSnippets(repoPath: string): Promise<Map<string, PapiRule>>;
+export declare function writeSnippet(repoPath: string, snippetName: string, content: PapiRule): Promise<void>;
+export declare function readMetadata(repoPath: string): Promise<{
+    envInfo: EnvInfo;
+    projectInfo: ProjectInfo;
+    hostnames: HostnameEntry[];
+}>;
+//# sourceMappingURL=snippets.d.ts.map

package/dist/config/snippets.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"snippets.d.ts","sourceRoot":"","sources":["../../src/config/snippets.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,QAAQ,EAAE,OAAO,EAAE,WAAW,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAC;AAEtF,wBAAsB,eAAe,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAmBvE;AAED,wBAAsB,YAAY,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC,CAKtE;AAED,wBAAsB,WAAW,CAAC,QAAQ,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,QAAQ,CAAC,CAK1F;AAED,wBAAsB,eAAe,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,GAAG,CAAC,MAAM,EAAE,QAAQ,CAAC,CAAC,CAYtF;AAED,wBAAsB,YAAY,CAChC,QAAQ,EAAE,MAAM,EAChB,WAAW,EAAE,MAAM,EACnB,OAAO,EAAE,QAAQ,GAChB,OAAO,CAAC,IAAI,CAAC,CAoBf;AAED,wBAAsB,YAAY,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC;IAC5D,OAAO,EAAE,OAAO,CAAC;IACjB,WAAW,EAAE,WAAW,CAAC;IACzB,SAAS,EAAE,aAAa,EAAE,CAAC;CAC5B,CAAC,CAcD"}

package/dist/config/snippets.js

@@ -0,0 +1,75 @@
+import { readdir, readFile, writeFile, mkdir, access } from 'node:fs/promises';
+import { resolve } from 'node:path';
+export async function findPmDirectory(repoPath) {
+    const entries = await readdir(repoPath, { withFileTypes: true });
+    const dirs = entries.filter(e => e.isDirectory());
+    // Primary: find a directory containing a config-snippets/ subdirectory
+    for (const dir of dirs) {
+        const candidate = resolve(repoPath, dir.name, 'config-snippets');
+        try {
+            await access(candidate);
+            return resolve(repoPath, dir.name);
+        }
+        catch {
+            // no config-snippets here, continue
+        }
+    }
+    throw new Error(`No Akamai property directory found in ${repoPath}. ` +
+        `Expected a directory containing config-snippets/ (Akamai CLI layout).`);
+}
+export async function listSnippets(repoPath) {
+    const pmDir = await findPmDirectory(repoPath);
+    const snippetsDir = resolve(pmDir, 'config-snippets');
+    const entries = await readdir(snippetsDir);
+    return entries.filter(f => f.endsWith('.json'));
+}
+export async function readSnippet(repoPath, snippetName) {
+    const pmDir = await findPmDirectory(repoPath);
+    const filePath = resolve(pmDir, 'config-snippets', snippetName);
+    const content = await readFile(filePath, 'utf-8');
+    return JSON.parse(content);
+}
+export async function readAllSnippets(repoPath) {
+    const names = await listSnippets(repoPath);
+    const pmDir = await findPmDirectory(repoPath);
+    const snippetsDir = resolve(pmDir, 'config-snippets');
+    const result = new Map();
+    for (const name of names) {
+        const content = await readFile(resolve(snippetsDir, name), 'utf-8');
+        result.set(name, JSON.parse(content));
+    }
+    return result;
+}
+export async function writeSnippet(repoPath, snippetName, content) {
+    const requiredFields = [
+        'name',
+        'children',
+        'behaviors',
+        'criteria',
+        'criteriaMustSatisfy',
+    ];
+    for (const field of requiredFields) {
+        if (!(field in content)) {
+            throw new Error(`Missing required PapiRule field: ${field}`);
+        }
+    }
+    const pmDir = await findPmDirectory(repoPath);
+    const snippetsDir = resolve(pmDir, 'config-snippets');
+    await mkdir(snippetsDir, { recursive: true });
+    const filePath = resolve(snippetsDir, snippetName);
+    await writeFile(filePath, JSON.stringify(content, null, 2) + '\n', 'utf-8');
+}
+export async function readMetadata(repoPath) {
+    const pmDir = await findPmDirectory(repoPath);
+    const [envRaw, projRaw, hostRaw] = await Promise.all([
+        readFile(resolve(pmDir, 'envInfo.json'), 'utf-8'),
+        readFile(resolve(pmDir, 'projectInfo.json'), 'utf-8'),
+        readFile(resolve(pmDir, 'hostnames.json'), 'utf-8'),
+    ]);
+    return {
+        envInfo: JSON.parse(envRaw),
+        projectInfo: JSON.parse(projRaw),
+        hostnames: JSON.parse(hostRaw),
+    };
+}
+//# sourceMappingURL=snippets.js.map

package/dist/config/snippets.js.map

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

package/dist/git/git-ops.d.ts

@@ -0,0 +1,16 @@
+export declare class GitError extends Error {
+    readonly exitCode?: number | undefined;
+    constructor(message: string, exitCode?: number | undefined);
+}
+export interface RemoteInfo {
+    host: string;
+    owner: string;
+    repo: string;
+}
+export declare function createBranch(repoPath: string, branchName: string): Promise<void>;
+export declare function commitAndPush(repoPath: string, message: string, files?: string[]): Promise<void>;
+export declare function getCurrentBranch(repoPath: string): Promise<string>;
+export declare function getRemoteUrl(repoPath: string): Promise<string>;
+export declare function parseRemoteUrl(url: string): RemoteInfo;
+export declare function buildBranchName(type: string, description: string): string;
+//# sourceMappingURL=git-ops.d.ts.map

package/dist/git/git-ops.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"git-ops.d.ts","sourceRoot":"","sources":["../../src/git/git-ops.ts"],"names":[],"mappings":"AAKA,qBAAa,QAAS,SAAQ,KAAK;aACY,QAAQ,CAAC,EAAE,MAAM;gBAAlD,OAAO,EAAE,MAAM,EAAkB,QAAQ,CAAC,EAAE,MAAM,YAAA;CAI/D;AAED,MAAM,WAAW,UAAU;IACzB,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,MAAM,CAAC;CACd;AAED,wBAAsB,YAAY,CAAC,QAAQ,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAEtF;AAED,wBAAsB,aAAa,CAAC,QAAQ,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CAStG;AAED,wBAAsB,gBAAgB,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAGxE;AAED,wBAAsB,YAAY,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAGpE;AAED,wBAAgB,cAAc,CAAC,GAAG,EAAE,MAAM,GAAG,UAAU,CActD;AAED,wBAAgB,eAAe,CAAC,IAAI,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,GAAG,MAAM,CAOzE"}