Skip to content

Instantly share code, notes, and snippets.

@esz135888
Created May 23, 2026 23:04
Show Gist options
  • Select an option

  • Save esz135888/7e1ab72e6257ec9bf05f90dd00dc784a to your computer and use it in GitHub Desktop.

Select an option

Save esz135888/7e1ab72e6257ec9bf05f90dd00dc784a to your computer and use it in GitHub Desktop.
PLS GitHub delivery repo context line pack - job 076b2cee

E2E Verification Plan

Verification Result For This Pack

Pack verification: created and published as shared-cloud artifact.

Code/deployment verification: not claimed. The PLS job context provided only a commit summary and did not provide repository URL, branch, PR URL, deployment URL, deliverable ID, or local code checkout.

D1 Human Verification

Ask lulu or the Operating Console owner to provide:

  1. Screenshot of Brain strategy execution graph with strategy and deliverable node types visible.
  2. API response excerpt showing node id, type, label, source.table, source.id, and synced_at.
  3. A test case where one strategy has at least one deliverable edge.
  4. A permission check from a user without strategy/deliverable access.

Acceptance Test Cases

Test 1: Strategy node source mapping. Expected: every strategy node maps to one monthly strategy source record.

Test 2: Deliverable node source mapping. Expected: every deliverable node maps to one strategy deliverable source record.

Test 3: Edge integrity. Expected: strategy-to-deliverable edges only exist when source relationship exists.

Test 4: Permission boundary. Expected: unauthorized user cannot inspect restricted node details.

Test 5: Fallback state. Expected: missing source record is visible as an unavailable state and creates an audit event.

Next-Round Evidence Upgrade

When repo URL or deployment URL is available, add automated verification:

  • API contract test for graph node payload.
  • UI screenshot test for graph rendering.
  • DB fixture test for strategy/deliverable edge integrity.
  • Permission regression test.

Artifact URL Or PR

Primary artifact: https://gist.github.com/esz135888/7e1ab72e6257ec9bf05f90dd00dc784a

PR/deployment: not claimed. The PLS context did not provide repository URL, PR URL, deployment URL, or local checkout.

Upload-files note: PLS context returned deliverable: null, so no deliverable_id was available for the fixed upload-files <job_id> <deliverable_id> <file...> helper. This pack uses a verified shared-cloud Gist as the primary artifact and records the missing deliverable context in the decision record.

Verification:

  • Gist published publicly.
  • HTTP and GitHub CLI verification completed before PLS completion writeback.

Data Model, API, Sync, Permissions, Audit

Proposed Data Model

repo_signal

  • id
  • org_id
  • project_id
  • repo
  • commit_sha
  • actor
  • summary
  • observed_at
  • source_url

graph_node_delivery_contract

  • id
  • repo_signal_id
  • node_type
  • source_table
  • source_record_id_field
  • display_label_field
  • link_rule
  • fallback_state
  • owner_profile_id
  • acceptance_status
  • accepted_at
  • accepted_by

graph_node_verification

  • id
  • contract_id
  • evidence_kind
  • evidence_ref
  • result
  • checked_by
  • checked_at
  • notes

API Contract

GET /api/brain/strategy-graph?project_id=:project_id

Expected response additions:

{
  "nodes": [
    {
      "id": "strategy:<strategy_id>",
      "type": "strategy",
      "label": "Monthly strategy title",
      "source": {
        "table": "monthly_strategies",
        "id": "<strategy_id>",
        "synced_at": "2026-05-24T10:00:00+08:00"
      },
      "permission_scope": "project.strategy.read"
    },
    {
      "id": "deliverable:<deliverable_id>",
      "type": "deliverable",
      "label": "Strategy deliverable title",
      "source": {
        "table": "strategy_deliverables",
        "id": "<deliverable_id>",
        "synced_at": "2026-05-24T10:00:00+08:00"
      },
      "permission_scope": "project.deliverable.read"
    }
  ],
  "edges": [
    {
      "from": "strategy:<strategy_id>",
      "to": "deliverable:<deliverable_id>",
      "type": "strategy_delivers"
    }
  ]
}

Sync Specification

Source: GitHub commit signal + Brain strategy graph DB loader.

Sync rule: a commit that changes graph node semantics must create or update a graph_node_delivery_contract.

Freshness rule: every strategy or deliverable node response must expose source table, source ID, and synced_at.

Failure rule: missing source records must render as an explicit unavailable/fallback state, not an unlabeled node.

Permissions

Users without project.strategy.read should not see strategy node details.

Users without project.deliverable.read should not see deliverable node details.

The graph may show aggregate counts only if permitted by org policy.

Audit Boundary

Audit events:

  • repo_signal.detected
  • graph_node_contract.created
  • graph_node_contract.acceptance_requested
  • graph_node_verification.submitted
  • graph_node_contract.accepted
  • graph_node_contract.rejected

Minimum audit payload: actor, project, commit SHA, node type, evidence ref, timestamp, and decision status.

Decision Record

Decision

Create a GitHub delivery repo-context pack for commit 0e5a318 instead of treating the signal as a plain LINE summary.

Problem

The PLS context included a GitHub delivery signal but no deliverable record, strategy record, action item, repository URL, PR URL, or deployment URL. Completing the job with a short text summary would not create an auditable artifact or adoption path.

Options

  1. Send a short LINE-style summary only.
  2. Fail or release the job because deliverable_id is missing.
  3. Produce a shared-cloud artifact pack that satisfies the required production artifacts and clearly records the missing context.

Recommendation

Use option 3.

Reasoning

The job's value is to advance a project signal into usable delivery context. A shared-cloud pack creates a primary artifact, E2E verification path, signal annotations, people sync, and learning memory. It also makes the missing deliverable_id visible without pretending upload-files succeeded.

Adoption Status

Recommended for immediate use.

Landing Path

  1. Publish shared-cloud Gist artifact.
  2. Complete PLS job with required artifact kinds.
  3. Send LINE card through PLS.
  4. Collect screenshot/API evidence.
  5. Update decision to adopted, limited rollout, or needs repair.

Feedback Needed If Not Adopted

If rejected, provide:

  • repo URL or PR URL
  • correct deliverable ID
  • desired recipient list
  • required acceptance owner
  • whether PLS should fail missing-deliverable jobs instead of producing shared-cloud artifacts
<!doctype html>
<html lang="zh-Hant">
<head>
<meta charset="utf-8">
<meta name="viewport" content="width=device-width, initial-scale=1">
<title>Operating Console GitHub Delivery Review</title>
<style>
:root {
--ink: #1d2433;
--muted: #5c667a;
--line: #d9dee8;
--panel: #ffffff;
--bg: #f5f7fb;
--accent: #116a5b;
--warn: #9a5b00;
}
body {
margin: 0;
font-family: -apple-system, BlinkMacSystemFont, "Segoe UI", sans-serif;
color: var(--ink);
background: var(--bg);
}
main {
max-width: 920px;
margin: 0 auto;
padding: 28px 18px 40px;
}
.panel {
background: var(--panel);
border: 1px solid var(--line);
border-radius: 8px;
padding: 22px;
}
h1 {
margin: 0 0 8px;
font-size: 24px;
line-height: 1.25;
}
h2 {
margin: 24px 0 10px;
font-size: 16px;
}
p, li {
font-size: 15px;
line-height: 1.55;
}
.meta {
display: grid;
grid-template-columns: repeat(auto-fit, minmax(190px, 1fr));
gap: 10px;
margin: 18px 0;
}
.cell {
border: 1px solid var(--line);
border-radius: 6px;
padding: 10px;
background: #fbfcff;
}
.label {
display: block;
color: var(--muted);
font-size: 12px;
margin-bottom: 4px;
}
code {
font-family: ui-monospace, SFMono-Regular, Menlo, Consolas, monospace;
font-size: 13px;
}
.status {
display: inline-block;
color: var(--accent);
border: 1px solid #9bc7bd;
border-radius: 999px;
padding: 4px 10px;
font-size: 13px;
font-weight: 650;
}
.warning {
color: var(--warn);
font-weight: 650;
}
.reply {
background: #eef7f5;
border-left: 4px solid var(--accent);
padding: 12px 14px;
border-radius: 4px;
}
</style>
</head>
<body>
<main>
<section class="panel">
<span class="status">D1 delivery review needed</span>
<h1>Operating Console graph node delivery check</h1>
<p>Commit <code>0e5a318</code> by <code>lulu</code> adds <code>strategy</code> and <code>deliverable</code> node types to the Brain strategy execution graph and loads monthly strategy / strategy deliverable data from the database.</p>
<div class="meta">
<div class="cell"><span class="label">Owner</span>Operating Console owner</div>
<div class="cell"><span class="label">Evidence source</span>lulu</div>
<div class="cell"><span class="label">Due</span>2026-05-24 18:00 Asia/Taipei</div>
<div class="cell"><span class="label">Acceptance</span>Screenshot/API proof, no orphan links</div>
</div>
<h2>Ask</h2>
<p>Reply with evidence that the graph now renders DB-backed <code>strategy</code> and <code>deliverable</code> nodes correctly.</p>
<ul>
<li>Graph screenshot or route URL.</li>
<li>API/DB mapping with source table, source ID, and synced timestamp.</li>
<li>One strategy-to-deliverable edge example.</li>
<li>Permission or fallback state confirmation.</li>
</ul>
<h2>Why it matters</h2>
<p>This is a management-facing graph change. The acceptance question is not whether the commit exists; it is whether people can use the Operating Console to judge strategy execution without misleading nodes, missing source records, or permission leaks.</p>
<h2>Reply format</h2>
<div class="reply">
<code>status=accepted|limited|repair_needed; evidence=&lt;url_or_screenshot_ref&gt;; blocker=&lt;none_or_text&gt;; next_owner=&lt;name&gt;; next_due=&lt;date&gt;</code>
</div>
<p class="warning">If no evidence arrives by the due time, keep the delivery in review instead of marking it adopted.</p>
</section>
</main>
</body>
</html>
{
"job_id": "076b2cee-f9c1-4c40-ae0b-de24be72b9b1",
"source": "company_signal_mastery",
"topic": "github-delivery-and-repo-context",
"project_name": "AI 推進專案:Operating Console 工具規格 的 30 天推進",
"commit_sha": "0e5a318",
"actor": "lulu",
"learning": [
"A GitHub commit signal should be converted into delivery context with owner, due date, acceptance checks, and evidence requirements.",
"Graph node feature signals require source-table mapping, permission boundary, stale-data handling, and screenshot/API proof before adoption.",
"When PLS context has no deliverable_id, the worker should publish a shared-cloud artifact and record upload-files as blocked rather than inventing a deliverable."
],
"next_round": [
"Ask PLS to include repo URL, PR URL, deliverable_id, and acceptance owner in company_signal_mastery jobs.",
"Create a reusable graph_node_delivery_contract template for future Operating Console commits.",
"Add stale-node watchdog checks for strategy and deliverable graph nodes."
],
"required_artifacts_satisfied": [
"primary_artifact",
"signal_annotations",
"solution_selection",
"skill_usage",
"market_maturity",
"production_readiness",
"production_acceptance",
"e2e_verification",
"people_sync",
"learning_memory"
]
}

Market Maturity Context

External Pattern

Modern delivery systems increasingly connect code changes to work context, ownership, and measurable delivery outcomes.

DORA frames software delivery performance around the ability to deliver software safely, quickly, and efficiently, which makes raw commit velocity insufficient without safety and verification evidence.

GitHub supports linking pull requests and issues so implementation work can be connected to planning and review context.

Backstage positions the software catalog as a centralized place for ownership and metadata across services, websites, libraries, data pipelines, and related software assets.

Implication For PLS

PLS should not treat a GitHub signal as a plain notification. A mature worker should convert repo activity into:

  • source evidence
  • owner and due date
  • product purpose
  • acceptance checks
  • permission and audit boundary
  • production-readiness status
  • learning memory

Maturity Rating

Current signal maturity: Level 2 of 5.

Reason: The commit evidence exists and has a clear project context, but the PLS context did not include a deliverable record, strategy record, action item, or verification artifact.

Target D30 maturity: Level 4 of 5.

Reason: Each repo signal should become a linked delivery contract with owner acceptance, graph/API evidence, and a reusable pattern for future node-type changes.

Sources

People Sync

LINE Draft

Operating Console delivery check: lulu 的 commit 0e5a318 已把 Brain 策略執行圖新增 strategy / deliverable 節點,並從 DB 載入月度策略與策略產出物。

請在 2026-05-24 18:00 前回一個可驗收證據:

  1. graph 畫面截圖或 route URL
  2. API/DB mapping,證明 node 有 source table、source id、synced_at
  3. strategy -> deliverable edge 的例子
  4. 權限或 fallback 狀態確認

驗收口徑:不是確認 commit 存在,而是確認 Operating Console 的策略/產出物脈絡真的可被人判斷、可被稽核、可進下一輪自動化。

Target People

  • lulu: implementation evidence source
  • Louis: PLS / delivery governance reviewer
  • Operating Console owner: acceptance decision owner

Expected Reply Format

status=accepted|limited|repair_needed; evidence=<url_or_screenshot_ref>; blocker=<none_or_text>; next_owner=<name>; next_due=<date>

Production Acceptance

Acceptance Owner

Operating Console owner.

Implementation evidence source: lulu.

Due

2026-05-24 18:00 Asia/Taipei.

Acceptance Checklist

  • The Brain graph route renders strategy nodes from DB-backed monthly strategy records.
  • The Brain graph route renders deliverable nodes from DB-backed strategy deliverable records.
  • Each rendered node has a stable ID, label, source table, source record ID, and sync timestamp.
  • Strategy-to-deliverable edges are present when source data has a relationship.
  • Missing or unauthorized source records render as explicit fallback states.
  • Reviewer can point from commit 0e5a318 to the graph route/API evidence.
  • Decision record is updated with adopted, limited rollout, or needs repair.

Stop Conditions

  • Graph shows strategy or deliverable nodes without source IDs.
  • Node labels are blank or ambiguous.
  • Permission checks expose restricted strategy/deliverable details.
  • Commit cannot be tied to the graph behavior being reviewed.
  • No screenshot/API evidence is returned by the D1 due date.

GitHub Delivery Repo Context Pack

Job: 076b2cee-f9c1-4c40-ae0b-de24be72b9b1 Source: company_signal_mastery / github-delivery-and-repo-context Project signal: AI 推進專案:Operating Console 工具規格 的 30 天推進 Primary evidence: commit 0e5a318 by lulu

Production Summary

This pack converts a single GitHub delivery signal into a reviewable PLS artifact. The commit adds strategy and deliverable node types to the Brain strategy execution graph, loads monthly strategy and strategy deliverable data from the database, and integrates those records into the graph structure.

The production risk is not code existence; the risk is whether repo delivery context reaches operators in a form they can verify. The pack therefore creates a LINE-ready delivery card, signal annotations, acceptance checks, data model, permissions and audit boundaries, and a decision record.

D1 / D7 / D14 / D30 Path

D1: Send the LINE review card to lulu, Louis, and the Operating Console owner. Acceptance is a screenshot or route/API proof that strategy and deliverable nodes render from DB-backed data, with no orphan links.

D7: Convert the one-off signal into a repeatable graph node delivery review. Confirm every new graph node type has source table, owner, render state, link rule, fallback state, and audit event.

D14: Add a stale-node watchdog and repo-context sync checklist for Brain graph changes. Any strategy or deliverable node missing source data, permission scope, or last sync timestamp becomes a review blocker.

D30: Promote the pattern into a reusable PLS GitHub delivery contract: commit/PR signal -> project context -> node contract -> acceptance evidence -> owner adoption -> learning memory.

Purpose-To-Purpose E2E

Original purpose: make Operating Console show strategy execution context, not only isolated tasks or implementation notes.

Production output: a GitHub delivery repo-context pack that translates commit 0e5a318 into operational review instructions, acceptance checks, and schema boundaries.

Human adoption: lulu and the owner review the rendered graph, attach screenshot/API proof, and confirm DB mapping and permission behavior.

Project, money, and risk improvement: review time drops because the commit is connected to strategy/deliverable context; delivery risk drops because orphan nodes and misleading graph states are caught before broad adoption; management value increases because strategy progress becomes visible inside the console.

Measurable loop: commit signal captured -> LINE card sent -> evidence returned -> acceptance checks passed -> PLS marks delivery context reusable -> D7/D14 follow-up tickets created where gaps remain.

Value And Money Path

Revenue: clearer Operating Console strategy views make the product easier to sell as an executive and delivery governance layer.

Cost saving: reduces manual explanation time after repo changes by bundling commit evidence, owner, due date, acceptance, and next action.

Risk reduction: prevents shipped graph features from silently misrepresenting strategy/deliverable relationships or exposing data outside the correct permission boundary.

Conversion: improves demo and stakeholder confidence because the graph can show what changed, why it matters, and how it was verified.

Labor leverage: turns one developer commit into a repeatable delivery-review workflow that future PLS workers can reuse.

Human Capability Improvement

The pack helps people become better at delivery governance. It gives operators a concrete way to inspect a repo change, connect it to strategy, request the right evidence, decide whether it is production-ready, and preserve learning memory for the next graph-node feature.

Owner / Due / Acceptance

Owner: Operating Console owner with lulu as implementation evidence source.

Due: 2026-05-24 18:00 Asia/Taipei for first screenshot/API verification.

Acceptance:

  • Commit 0e5a318 is linked to the Operating Console graph-node delivery record.
  • strategy and deliverable nodes render from DB-backed monthly strategy and strategy deliverable data.
  • Node link rules are documented and no orphan graph links appear in test data.
  • Permission and audit expectations are confirmed.
  • Decision record is reviewed and updated with adopted/not-adopted status.

Signal Annotations

Source Signal

Signal type: GitHub commit delivery context Commit: 0e5a318 Actor: lulu Project: bbdb46d5-0385-4181-8cba-82785036ed96 Project name: AI 推進專案:Operating Console 工具規格 的 30 天推進 Commit count: 1

Signal text:

在 Brain 策略執行圖中新增 strategy 與 deliverable 節點類型,從資料庫載入月度策略與策略產出物資料並整合進圖結構

Annotation

This is a production-context signal, not a marketing update. It indicates that the Brain strategy execution graph is gaining two management-facing node types: strategy and deliverable.

Interpreted Intent

The commit attempts to let the Operating Console represent strategy and deliverable context directly in the graph. That should make monthly strategy and strategy output status visible to people who manage delivery, instead of forcing them to reconstruct context from separate database records or commit logs.

Risk Tags

  • graph_semantics: New node types can confuse users if links, labels, or states are unclear.
  • db_source_mapping: Monthly strategy and strategy deliverable records must be traceable to exact source tables and IDs.
  • permission_boundary: Strategy and deliverable nodes may expose management context that should respect workspace/project permissions.
  • stale_context: Graph nodes can become misleading if source records change without sync timestamps.
  • adoption_gap: A successful commit is not the same as owner-reviewed delivery.

Required Evidence

  • Screenshot or URL of the Brain graph showing strategy and deliverable nodes.
  • API or DB mapping proof showing source record IDs and node IDs.
  • Confirmation of how missing strategy/deliverable records render.
  • Confirmation of permission behavior for users without access to the source project.
  • Owner decision on whether this is production-ready, limited rollout, or needs repair.

Skill Usage

Applied model: purpose_e2e_toolbox_v2

How The Model Was Used

Purpose framing: The commit was translated from raw repo activity into the product purpose of making Operating Console strategy execution visible and governable.

E2E chain: The pack defines the measurable path from GitHub commit to PLS signal, LINE review, evidence capture, owner acceptance, and learning memory.

Value path: The pack identifies revenue, cost, risk, conversion, and labor-leverage improvements tied to the delivery signal.

Human capability: The pack gives reviewers a practical method for deciding whether graph-node delivery is ready, not just a summary of what changed.

Solution stack: The output includes context framework, workflow, schema/API thinking, tool artifact, acceptance checks, adoption path, and decision record.

Anti-laziness gate: The job is not marked complete with text alone; it includes an openable primary artifact, owner/due/acceptance, E2E evidence path, data/toolbox upgrade path, and decision record.

Solution Selection

Options Considered

Option A: Treat the signal as a LINE message only.

Option B: Create a full engineering project spec.

Option C: Create a production delivery-context pack with LINE card, signal annotations, acceptance checks, data model, and decision record.

Recommendation

Choose Option C.

Rationale

The signal is already a GitHub delivery event, so the immediate need is not ideation or a fresh build. The need is to connect the commit to project purpose, human review, and production evidence. A delivery-context pack is the smallest artifact that still creates an end-to-end adoption loop.

Option A is too thin because it would push a message without acceptance criteria. Option B is too heavy because the implementation already exists. Option C lets PLS turn the commit into a reviewable, auditable, repeatable operating artifact.

Adoption Status

Recommended for immediate D1 use.

Landing Path

Send the LINE review card, collect evidence, update the decision record, and create D7/D14 follow-up tasks for any failed checks.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment